Handling withdrawal transactions

Understand how to properly work with withdrawal transactions in your Bank Statement

Withdrawals are the type of payment which represents the act of sending a token fro within the platform to any external destination directly. It usually represents bank transfers(TED).
If you want to know how you can create a transaction you can check out External bank transfers (TED)
Below we see how a withdrawal transaction looks like in both STR Provider and DOCK Provider.

📘

New Feature

The banking object in the root of the transaction is a feature only available in 2.0.8


DOCK Provider

{
        "banking": {
            "accountDigit": "2",
            "account": 12345,
            "agencyDigit": "0",
            "agency": 12,
            "bank": "341",
            "type": "checking",
            "holderType": "personal",
            "taxId": "01234567890",
            "name": "Joao Brito",
            "updatedAt": "2019-07-08T17:45:50.890Z",
            "createdAt": "2019-07-08T17:45:50.890Z",
            "id": "decefd3b-c725-4b5f-9cc8-8da3ec94f961"
        },
        "payments": [
            {
                "status": "settled",
                "type": "withdrawal",
                "destination": {
                    "id": "0041a0e8-c096-4946-bbbe-63609bf8c67b",
                    "root": true,
                    "stellar": {
                        "publicKey": "GAGPSIHDVEMMMH55GI3YNNR4KPU4OKZGF3XBOWYRCJWCNZNT4PHVI2DC"
                    },
                    "updatedAt": "2019-06-27T19:27:23.823Z",
                    "createdAt": "2019-06-27T19:27:23.823Z",
                    "user": {
                        "id": "417c7972-cc9b-4b23-b956-5a87d06ed587",
                        "name": "Bit Capital Issuer",
                        "firstName": "Bit Capital",
                        "lastName": "Issuer",
                        "email": "[email protected]",
                        "role": "admin",
                        "twoFactorRequired": false,
                        "updatedAt": "2019-06-27T19:27:23.814Z",
                        "createdAt": "2019-06-27T19:27:23.814Z"
                    }
                },
                "amount": "1.00",
                "asset": {
                    "id": "1edf6304-fb5d-4208-9444-93a99b9d10f1",
                    "name": "BRL Digital",
                    "code": "BRLD",
                    "root": true,
                    "provider": "cdt-visa",
                    "updatedAt": "2019-06-27T19:27:23.834Z",
                    "createdAt": "2019-06-27T19:27:23.834Z"
                },
                "scheduleFor": null,
                "updatedAt": "2020-04-01T14:31:56.428Z",
                "createdAt": "2020-03-31T19:01:21.015Z",
                "id": "00323b26-0028-4ea6-a6ff-9b98191ae5f2"
            }
        ],
        "source": {
            "id": "5fd48d30-f9f3-452e-93ba-c13d6c8ff1ce",
            "stellar": {
                "publicKey": "GA6A4OSFYBASFIEOMGBCSQEUVV6CHECIMAXRWJ4OSYG666BXH4S4US66"
            },
            "updatedAt": "2019-06-28T17:23:24.981Z",
            "createdAt": "2019-06-28T17:23:24.981Z",
            "user": {
                "id": "891fa348-c676-458e-ba59-7fe4400c7849",
                "name": "JOÃO BRITO",
                "firstName": "JOÃO",
                "lastName": "BRITO",
                "email": "[email protected]",
                "role": "consumer",
                "twoFactorRequired": false,
                "updatedAt": "2019-09-16T18:41:03.096Z",
                "createdAt": "2019-06-28T17:23:24.265Z"
            }
        },
        "states": [
            {
                "additionalData": {},
                "updatedAt": "2020-04-01T14:31:59.616Z",
                "createdAt": "2020-04-01T14:31:59.616Z",
                "status": "notified",
                "id": "963d42d5-fe55-42c9-b1ba-2ec127674400"
            },
            {
                "additionalData": {},
                "updatedAt": "2020-04-01T14:31:59.193Z",
                "createdAt": "2020-04-01T14:31:59.193Z",
                "status": "executed",
                "id": "bb1da099-2b14-4340-83d1-af7563cc9dee"
            },
            {
                "additionalData": {
                    "authorized": [
                        {
                            "provider": "cdt-visa",
                            "payment": "f6d22a89-c17d-45aa-a8e9-2b7380098db2",
                            "asset": "BRLD"
                        }
                    ],
                    "skipped": [
                        {
                            "provider": "cdt-visa",
                            "payment": "00323b26-0028-4ea6-a6ff-9b98191ae5f2",
                            "asset": "BRLD"
                        }
                    ]
                },
                "updatedAt": "2020-03-31T19:01:20.999Z",
                "createdAt": "2020-03-31T19:01:21.125Z",
                "status": "AUTHORIZED",
                "id": "99761b04-ccf2-4269-a70e-f3d420cf10d7"
            },
            {
                "additionalData": {},
                "updatedAt": "2020-03-31T19:01:21.009Z",
                "createdAt": "2020-03-31T19:01:21.009Z",
                "status": "pending",
                "id": "18c58bc5-d492-489e-be0d-6d9fb04d61eb"
            }
        ],
        "updatedAt": "2020-04-01T14:31:59.030Z",
        "createdAt": "2020-03-31T19:01:21.004Z",
        "additionalData": {
            "externalTransaction": {
                "createdAt": "2020-03-31T16:01:24.068",
                "id": "911738068-2815-969430261 610374-767122-759326"
            },
            "statusDescription": "CREDIT_DONE",
            "transactionDate": "Mar 31, 2020 4:01:22 PM",
            "transactionId": "240473028-3226-557730165 053893-605297-347220",
            "digitAccount": "2",
            "adjustmentId": 13336,
            "accountType": "fisico",
            "successful": true,
            "wallet_id": "5fd42330-f9f3-452e-93ba-c13d6c8ff1ce",
            "timestamp": 1585751515741,
            "recipient": {
                "transferStatusCode": "00",
                "statusDescription": "CREDIT_DONE",
                "transferSuccess": true,
                "transactionCode": "240473028-3226-557730165 053893-605297-347220",
                "originAccount": 37,
                "adjustmentId": 13696,
                "accountDigit": "2",
                "branchDigit": "0",
                "accountType": "fisico",
                "timestamp": 1585751515741,
                "issuerId": 108,
                "fileName": "2020040115630.ret",
                "account": 123456,
                "branch": 12,
                "value": 1,
                "taxId": 1234567890,
                "name": "Joao Brito",
                "date": "Mar 31, 2020 4:01:22 PM",
                "bank": 341,
                "uid": "108.02e19895-7382-11ea-bc00-0242ac11000a",
                "id": 127366
            },
            "bankingId": "decefd3b-c725-4b5f-9cc8-8da3ec94f961",
            "accountId": 00,
            "issuerId": 00,
            "fileName": "2020040115630.ret",
            "document": 1234567890,
            "account": 123467,
            "status": "00",
            "amount": 1,
            "agency": 12,
            "digit": "0",
            "type": "BANKTRANSFER-CASH-OUT",
            "name": "Joao Brito",
            "hash": "4dc8222dbb7073eeb7479b58277d3fbdd9d58ba704615c40947e5730ed74ae8b",
            "bank": 341,
            "uid": "108.02e19895-7382-11ea-bc00-0242ac11000a",
            "str": {},
            "id": 127366
        },
        "status": "notified",
        "type": "payment",
        "id": "8fdd2f86-681d-4632-b71c-65bfa7169ac3"
}

STR Provider

{
        "banking": {
            "accountDigit": "2",
            "account": 12345,
            "agencyDigit": "0",
            "agency": 12,
            "bank": "341",
            "type": "checking",
            "holderType": "personal",
            "taxId": "01234567890",
            "name": "Joao Brito",
            "updatedAt": "2019-07-08T17:45:50.890Z",
            "createdAt": "2019-07-08T17:45:50.890Z",
            "id": "decefd3b-c725-4b5f-9cc8-8da3ec94f961"
        },
        "payments": [
            {
                "status": "settled",
                "type": "withdrawal",
                "destination": {
                    "id": "54d62d41-585b-455a-a730-78cbac0d947e",
                    "root": true,
                    "stellar": {
                        "publicKey": "GAGPSIHDVEMMMH55GI3YNNR4KPU4OKZGF3XBOWYRCJWCNZNT4PHVI2DC"
                    },
                    "updatedAt": "2019-11-13T02:30:33.449Z",
                    "createdAt": "2019-11-13T02:30:33.449Z",
                    "user": {
                        "id": "28fe4065-e3a8-4e01-8d7e-8f7842504502",
                        "name": "Bit Capital Issuer",
                        "firstName": "Bit Capital",
                        "lastName": "Issuer",
                        "email": "[email protected]",
                        "role": "admin",
                        "twoFactorRequired": false,
                        "updatedAt": "2019-11-13T02:30:33.420Z",
                        "createdAt": "2019-11-13T02:30:33.420Z"
                    }
                },
                "amount": "5",
                "asset": {
                    "id": "5858aaaf-acfe-4ab3-b981-bba22aa20109",
                    "name": "BRL Parati",
                    "code": "BRLP",
                    "root": true,
                    "provider": "parati-provider",
                    "updatedAt": "2019-11-13T02:30:33.573Z",
                    "createdAt": "2019-11-13T02:30:33.573Z"
                },
                "scheduleFor": null,
                "updatedAt": "2020-04-20T16:03:05.508Z",
                "createdAt": "2020-04-20T16:01:50.068Z",
                "id": "4721d2d4-f303-4a1f-8bb8-edfae194684e"
            }
        ],
        "source": {
            "id": "75e4f719-081c-42d8-863d-f32861f389e9",
            "stellar": {
                "publicKey": "GC53Z7BOVVPLGPVOSZTJSBDX2AAW7LX5UUI63R5Z62VQRTQ52JRXVHFV"
            },
            "updatedAt": "2019-11-13T02:47:57.864Z",
            "createdAt": "2019-11-13T02:47:57.864Z",
            "user": {
                "id": "bb8fe757-4470-40ba-b3e8-c86e630441cb",
                "name": "João Brito",
                "firstName": "João",
                "lastName": "Brito",
                "email": "[email protected]",
                "role": "consumer",
                "twoFactorRequired": false,
                "updatedAt": "2019-11-13T02:47:57.647Z",
                "createdAt": "2019-11-13T02:47:57.653Z"
            }
        },
        "states": [
            {
                "additionalData": {},
                "updatedAt": "2020-04-20T16:03:13.736Z",
                "createdAt": "2020-04-20T16:03:13.736Z",
                "status": "notified",
                "id": "ad5ff4a4-a1f4-416d-aa25-9b06cbfd6466"
            },
            {
                "additionalData": {},
                "updatedAt": "2020-04-20T16:03:12.546Z",
                "createdAt": "2020-04-20T16:03:12.546Z",
                "status": "executed",
                "id": "ad99f098-c80d-4a25-9bc8-3aa14b4ccd92"
            },
            {
                "additionalData": {
                    "authorized": [],
                    "skipped": [
                        {
                            "provider": "parati-provider",
                            "payment": "4721d2d4-f303-4a1f-8bb8-edfae194684e",
                            "asset": "BRLP"
                        }
                    ]
                },
                "updatedAt": "2020-04-20T16:03:06.728Z",
                "createdAt": "2020-04-20T16:01:50.239Z",
                "status": "AUTHORIZED",
                "id": "6f5c392e-5e8a-44de-8249-dab156c78f6b"
            },
            {
                "additionalData": {},
                "updatedAt": "2020-04-20T16:01:50.062Z",
                "createdAt": "2020-04-20T16:01:50.062Z",
                "status": "pending",
                "id": "78be82da-ae23-4cde-97b9-1bac757a6022"
            }
        ],
        "updatedAt": "2020-04-20T16:03:12.442Z",
        "createdAt": "2020-04-20T16:01:50.055Z",
        "additionalData": {
            "transactionId": "AlEEq52CQMQWUJce_LlsH",
            "destination": {
                "accountHolderTaxId": "01234567890",
                "accountHolderName": "João Brito",
                "accountNumber": "123456-7",
                "branchNumber": 1,
                "bankNumber": "260"
            },
            "bankingId": "f6adbcc3-de77-4955-88e2-a728aaaf8dd2",
            "hash": "6b091e8f1ac35ff122e0d12f78b0b32ce3e612b9b691f74d886249e58a88d50c",
            "str": {}
        },
        "status": "notified",
        "type": "payment",
        "id": "052271df-94e1-4ed8-bcd2-4c6e7fcc619a"
    }

Did this page help you?