Scheduled Disburse Money

Disburse endpoint can also perform scheduled disbursement by adding a new parameter in the request.

POST/disburse?walletReferenceId={walletReferenceId}&scheduledDate={datetime}

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.

Note: scheduledDate parameter is required if user wants to send a scheduled disbursement request.

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.

You may refer to Disburse Money section for getting payload format for each facilities.

Request Sample

Scheduled Disburse

    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

201401

{
  "timestamp": "2025-08-07 06:52:37 +8000",
  "status": 201,
  "message": "Created",
  "path": "/disburse",
  "data": {
      "merchantReference": "PESONETTEST202508070001",
      "status": "SCHEDULED",
      "statusDescription": "Scheduled disbursement successfully created",
      "scheduledDate": "2025-08-07T10:30:00+08:00"
  }
}

{
  "timestamp": "2021-06-13 07:11:19 +0000",
  "status": 401,
  "error": "Unauthorized",
  "path": "/disburse"
}

Responses

201 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
merchantReference	string	Merchant reference of the disbursement.
status	string	Status of the scheduled disbursement.
statusDescription	string	Status description of the status code.
scheduledDate	string	Schedule of the disbursement to be executed.

400 Erroneous Response

Disburse Money Erroneous Response Parameters!