Disburse Money
Depending on the disbursement facility to be used, to disburse money, send the request headers and body parameters via POST.
POST/disburse?walletReferenceId={walletReferenceId}
Header Parameters
| Parameter | Required? | Type | Description |
|---|---|---|---|
| Content-Type | Optional | string | Default content type of the API. |
| Authorization | Required | string | Unique identifier of the integrator. |
Query Parameters
| Parameter | Required? | Type | Description |
|---|---|---|---|
| walletReferenceId | Required | string | Unique Identifier for wallet. |
| scheduledDate | Optional | string | Date for the scheduled disbursement. |
Request Body
| Parameter | Required? | Type | Description |
|---|---|---|---|
| payload | Required | string | Generated JSON Web Token (JWT) from transaction data signed with integrator's secret using HS256 algorithm. |
Once the instructions are submitted, the integrator can check the status of disbursement items from time to time. The integrator should be aware that each facility has different result codes.
Transaction Payload
{
"data": {
"transactionComplianceRequest": {}, //Use API reference for details
"merchantReference": "sampleMerchantReference",
"facility": "facilityjwt",
"items": [
{
"reference": "091234546789",
"amount": "1.00",
"notification": {
"notify": true,
"type": "email",
"email": "email@email.com"
}
}
]
}
}
Sequence Diagram for Disbursements
The integrator can access API functions to process disbursements. First, the integrator should get all the disbursement facilities available to their account. After that, the integrator can submit disbursement instructions to the selected facility. The number of instructions for sending depends on the capability of the facility.
Once the instructions are submitted, the integrator can check the status of disbursement items from time to time. The integrator should be aware that each facility has different result codes.
{
"data": {
"transactionComplianceRequest": {}, //Use API reference for details
"merchantReference": "sampleMerchantReference",
"facility": "facilityjwt",
"items": [
{
"customParameters": {
"currency": "123",
"bic": "SAMPLEBICXX",
"pin": "111111",
"param1": "123",
"param2": "123",
"param3": "123",
"custno": "123",
"purpose": "Test Credit Transfer"
},
"reference": "12345678909",
"amount": "1.00",
"notification": {
"notify": true,
"type": "email",
"email": "email@email.com"
}
}
]
}
}
Sequence Diagram for Disbursements
The integrator can access API functions to process disbursements. First, the integrator should get all the disbursement facilities available to their account. After that, the integrator can submit disbursement instructions to the selected facility. The number of instructions for sending depends on the capability of the facility.
Once the instructions are submitted, the integrator can check the status of disbursement items from time to time. The integrator should be aware that each facility has different result codes.
{
"data": {
"transactionComplianceRequest": {}, //Use API reference for details
"merchantReference": "sampleMerchantReference",
"facility": "facilityjwt",
"items": [
{
"customParameters": {
"currency": "123",
"bic": "SAMPLEBICXX",
"name": "111111",
"address": "123 St."
},
"reference": "12345678909",
"amount": "1.00",
"notification": {
"notify": true,
"type": "email",
"email": "email@email.com"
}
}
]
}
}
Sequence Diagram for Disbursements
The integrator can access API functions to process disbursements. First, the integrator should get all the disbursement facilities available to their account. After that, the integrator can submit disbursement instructions to the selected facility. The number of instructions for sending depends on the capability of the facility.
Once the instructions are submitted, the integrator can check the status of disbursement items from time to time. The integrator should be aware that each facility has different result codes.
{
"data": {
"transactionComplianceRequest": {}, //Use API reference for details
"merchantReference": "sampleMerchantReference",
"facility": "{facilityjwt}",
"items": [
{
"reference": "1234567127893",
"amount": "1.00",
"customParameters": {
"lastName": "Sender",
"country": "AUS",
"bankCode": "CBA",
"purpose": "Test Credit Transfer",
"postcode": "1234",
"individualOrBusiness": "I",
"bsb": "063259",
"firstName": "John",
"emailAddress": "email@email.com",
"dob": "01/01/01",
"addressLine1": "Test",
"suburb": "Sydney",
"state": "NSW"
},
"notification": {
"notify" true,
"type": "EMAIL",
"email": "email1@email.com"
}
}
]
}
}
{
"data": {
"transactionComplianceRequest": {}, //Use API reference for details
"merchantReference": "sampleMerchantReference",
"facility": "{facilityjwt}",
"items": [
{
"reference": "1234517948245",
"amount": "1.00",
"customParameters": {
"individualOrBusiness": "B",
"businessName": "Sample Business",
"abn": "51865951562",
"addressLine1": "Test",
"suburb": "Sydney",
"state": "NSW",
"postcode": "1234",
"country": "AUS",
"emailAddress": "email@email.com",
"bankCode": "CBA",
"bsb": "037520",
"dob": "01/01/01",
"purpose": "Test Credit Transfer"
},
"notification": {
"notify" true,
"type": "EMAIL",
"email": "email1@email.com"
}
}
]
}
}
Sequence Diagram for Disbursements
The integrator can access API functions to process disbursements. First, the integrator should get all the disbursement facilities available to their account. After that, the integrator can submit disbursement instructions to the selected facility. The number of instructions for sending depends on the capability of the facility.
Once the instructions are submitted, the integrator can check the status of disbursement items from time to time. The integrator should be aware that each facility has different result codes.
{
"data": {
"transactionComplianceRequest": {}, //Use API reference for details
"merchantReference": "sampleMerchantReference",
"facility": "{facilityjwt}",
"items": [
{
"customParameters": {
"bankSwiftCode": "XXXXXXXX",
"city": "Sample City",
"country": "GB",
"customerId": "ABC1234567890",
"email": "john.doe@email.com",
"individual": {
"birthDate": "1990-01-01",
"birthPlace": "Birth Place",
"documentNumber": "AB123456",
"documentType": "passport",
"expirationDate": "2030-01-01",
"issuedBy": "US Deparment of State",
"issuedCountryCode": "GB",
"issueDate": "2020-01-01",
"firstName": "John",
"middleName": "Dee",
"lastName": "Doe"
},
"payeeType": "INDIVIDUAL",
"phone": "15555555555",
"purpose": "Test",
"state": "Test State",
"street": "123 St.",
"zip": "10001"
},
"reference": "{accountNumber}",
"amount": "1.00",
"notification": {
"notify": true,
"type": "email",
"email": "email@email.com"
}
}
]
}
}
{
"data": {
"transactionComplianceRequest": {}, //Use API reference for details
"merchantReference": "sampleMerchantReference",
"facility": "{facilityjwt}",
"items": [
{
"customParameters": {
"bankSwiftCode": "XXXXXX",
"city": "Sample City",
"corporate": {
"corporateName": "Sample Corp."
},
"country": "GB",
"customerId": "ABC1234567890",
"email": "email@email.com",
"payeeType": "CORPORATE",
"phone": "15555555555",
"purpose": "Test",
"state": "Test State",
"street": "123 St.",
"zip": "10001"
},
"reference": "{accountNumber}",
"amount": "1.00",
"notification": {
"notify": true,
"type": "email",
"email": "email1@email.com"
}
}
]
}
}
Sequence Diagram for Disbursements
The integrator can access API functions to process disbursements. First, the integrator should get all the disbursement facilities available to their account. After that, the integrator can submit disbursement instructions to the selected facility. The number of instructions for sending depends on the capability of the facility.
Once the instructions are submitted, the integrator can check the status of disbursement items from time to time. The integrator should be aware that each facility has different result codes.
{
"data": {
"transactionComplianceRequest": {}, //Use API reference for details
"merchantReference": "sampleMerchantReference",
"facility": "facilityjwt",
"items": [
{
"customParameters": {
"bankSwiftCode": "XXXXXXX XXX",
"city": "Test City",
"country": "GB",
"customerId": "123456789",
"email": "email@email.com",
"individual": {
"birthDate": "1994-01-01",
"birthPlace": "Philippines",
"documentNumber": "123456789",
"expirationDate": "2030-01-01",
"firstName": "John",
"issuedBy": "DFA MANILA",
"issuedCountryCode": "PH",
"issuedDate": "2020-01-01",
"lastName": "Doe",
"middleName": "Dee"
},
"payeeType": "INDIVIDUAL",
"phone": "+123347857918",
"purpose": "Test",
"state": "UK",
"street": "Test",
"zip": "1234"
},
"reference": "{accountNumber}",
"amount": "1.00",
"notification": {
"notify": true,
"type": "email",
"email": "email@email.com"
}
}
]
}
}
Sequence Diagram for Disbursements
The integrator can access API functions to process disbursements. First, the integrator should get all the disbursement facilities available to their account. After that, the integrator can submit disbursement instructions to the selected facility. The number of instructions for sending depends on the capability of the facility.
Once the instructions are submitted, the integrator can check the status of disbursement items from time to time. The integrator should be aware that each facility has different result codes.
Request Sample
curl
-X POST "https://test-api-dbm.tlpe.io/disburse?walletReferenceId={walletReferenceId}" \
-H "Content-Type: application/json" \
-H "Authorization: {integratorToken}" \
-d "{
"payload": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.ew0KICAiZGF0YSI6IHsNCiAgICAgIm1lcmNoYW50UmVmZXJlbmNlIjogIkRCTVRFU1QxNTEyMjEwMDAxIiwNCiAgImZhY2lsaXR5IjogImV5SjBlWEFpT2lKS1YxUWlMQ0poYkdjaU9pSklVekkxTmlKOS5leUpwYzNNaU9pSkVRazBpTENKemRXSWlPaUpFYVhOaWRYSnpaVzFsYm5RZ0tFUkNUU2tnUVhWMGFHVnVkR2xqWVhScGIyNGlMQ0poZFdRaU9pSkVhWE5pZFhKelpXMWxiblFnS0VSQ1RTa2lMQ0psZUhBaU9qRTJNemszTURnM01USXNJbWxoZENJNk1UWXpPVGN3TmpreE1pd2lhblJwSWpvaU5HUm1ZMlE1WXpndE5EVXdaUzAwTmpobExUZ3pNR1l0TXpJek0yTmpZek01T1Rka0lpd2ljR2xrSWpvaVpXUmlNRE5pT1RZdE0yWTBNaTAwWkRreExUZ3lZekF0WWpSbFlUazBORFF6TkRVekluMC5GaENzbEZOa0pfT2p6Zmx0Tjh0dmQ5UjZfWEQ3WVJPOEs4TlpjQzBKTjBNIiwNCiAgIml0ZW1zIjogWw0KICAgIHsNCiAgICAgICJyZWZlcmVuY2UiOiAiMDk2NjU4NDkwMjEiLA0KICAgICAgImFtb3VudCI6ICIxIg0KICAgIH0NCiAgXQ0KICB9DQogIA0KfQ._t5OR92eYiY5HhUUjG7K51Qj3x4fkydnLCSODIrSAeI"
}
curl
-X POST "https://test-api-dbm.tlpe.io/disburse?walletReferenceId={walletReferenceId}&scheduledDate=2025-08-07T10%3A30%3A00%2B08%3A00" \
-H "Content-Type: application/json" \
-H "Authorization: {integratorToken}" \
-d "{
"payload": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.ew0KICAiZGF0YSI6IHsNCiAgICAgIm1lcmNoYW50UmVmZXJlbmNlIjogIkRCTVRFU1QxNTEyMjEwMDAxIiwNCiAgImZhY2lsaXR5IjogImV5SjBlWEFpT2lKS1YxUWlMQ0poYkdjaU9pSklVekkxTmlKOS5leUpwYzNNaU9pSkVRazBpTENKemRXSWlPaUpFYVhOaWRYSnpaVzFsYm5RZ0tFUkNUU2tnUVhWMGFHVnVkR2xqWVhScGIyNGlMQ0poZFdRaU9pSkVhWE5pZFhKelpXMWxiblFnS0VSQ1RTa2lMQ0psZUhBaU9qRTJNemszTURnM01USXNJbWxoZENJNk1UWXpPVGN3TmpreE1pd2lhblJwSWpvaU5HUm1ZMlE1WXpndE5EVXdaUzAwTmpobExUZ3pNR1l0TXpJek0yTmpZek01T1Rka0lpd2ljR2xrSWpvaVpXUmlNRE5pT1RZdE0yWTBNaTAwWkRreExUZ3lZekF0WWpSbFlUazBORFF6TkRVekluMC5GaENzbEZOa0pfT2p6Zmx0Tjh0dmQ5UjZfWEQ3WVJPOEs4TlpjQzBKTjBNIiwNCiAgIml0ZW1zIjogWw0KICAgIHsNCiAgICAgICJyZWZlcmVuY2UiOiAiMDk2NjU4NDkwMjEiLA0KICAgICAgImFtb3VudCI6ICIxIg0KICAgIH0NCiAgXQ0KICB9DQogIA0KfQ._t5OR92eYiY5HhUUjG7K51Qj3x4fkydnLCSODIrSAeI"
}
Response Samples
{
"timestamp": "2021-06-13 06:52:37 +0000",
"status": 200,
"message": "OK",
"path": "/disburse",
"data": {
"transactionReference": "{transactionReference
}",
"statusCode": "OK.00.10",
"statusDescription": "Disbursement request successful"
}
}
{
"timestamp": "2021-06-13 07:11:19 +0000",
"status": 401,
"error": "Unauthorized",
"path": "/disburse"
}
Responses
200 Successful Response
| Parameter | Type | Description |
|---|---|---|
| timestamp | string | Request timestamp. |
| status | string | HTTP status code. |
| message | string | HTTP status code message/description. |
| path | string | Endpoint path used for the request. |
| data | object | Contains request related response. |
Data Parameters
| Parameter | Type | Description |
|---|---|---|
| transactionReference | string | Transaction reference of the disbursement. |
| statusCode | string | Status code of the disbursement. |
| statusDescription | string | Status description of the status code. |
400 Erroneous Response
