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"
}
Updated almost 4 years ago