Disburse Money

Depending on the disbursement facility to be used, to disburse money, send the request headers and body parameters via POST.

POST/disburse

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.

Disburse to InstaPay

{
    "data": {
     "merchantReference":"DIZTEST1512210001",
      "facility":"{jwtString}",
      "items":[
         {
            "customParameters":{
               "currency":"{ISO4217codeOfPHP}",
               "bic":"{bankCode}",
               "pin":"111111",
               "param1":"",
               "param2":"",
               "param3":"",
               "custno":"",
               "purpose":"Credit Transfer"
           },
             "reference":"{accountNumber}",
             "amount":"1.00",
             "notification":{
              "notify":"{true/false}",
              "type":"email",
              "email":"{receiverEmail}"
            }
         }
      ]
    }
  }

See API Reference > Transaction Body Payload Data for a more guided requirement.

Request Samples

PayloadcURL

{
  "data": {
  "merchantReference":"DIZTEST1512210001",
    "facility":"{jwtString}",
    "items":[
      {
          "customParameters":{
            "currency":"608",
            "bic":"{bankCode}",
            "pin":"111111",
            "param1":"",
            "param2":"",
            "param3":"",
            "custno":"",
            "purpose":"Credit Transfer"
        },
          "reference":"{accountNumber}",
          "amount":"1.00",
          "notification":{
            "notify":"{true/false}",
            "type":"email",
            "email":"{receiverEmail}"
          }
      }
    ]
  }
}

curl
-X POST "https://test-api-dbm.tlpe.io/disburse" \
-H "Content-Type: application/json" \
-H "Authorization: {integratorToken}" \
-d "{
      "payload": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.
      eyJkYXRhIjp7ImN1c3RvbWVyIjp7ImZpcnN0X25hbWUiOiJ7Zmlyc3ROYW1lfSIsImxhc3RfbmFtZSI6IntsYXN0TmFtZX0iLCJiaWxsaW5nX2FkZHJlc3MiOnsibGluZTEiOiJ7YWRkcmVzc0xpbmUxfSIsImxpbmUyIjoie2FkZHJlc3NMaW5lMn0iLCJjaXR5X211bmljaXBhbGl0eSI6IntjaXR5fSIsInppcCI6Int6aXBDb2RlfSIsInN0YXRlX3Byb3ZpbmNlX3JlZ2lvbiI6IntzdGF0ZX0iLCJjb3VudHJ5X2NvZGUiOiJ7Y291bnRyeUNvZGV9In0sInNoaXBwaW5nX2FkZHJlc3MiOnsibGluZTEiOiJ7YWRkcmVzc0xpbmUxfSIsImxpbmUyIjoie2FkZHJlc3NMaW5lMn0iLCJjaXR5X211bmljaXBhbGl0eSI6IntjaXR5fSIsInppcCI6Int6aXBDb2RlfSIsInN0YXRlX3Byb3ZpbmNlX3JlZ2lvbiI6IntzdGF0ZX0iLCJjb3VudHJ5X2NvZGUiOiJ7Y291bnRyeUNvZGV9In0sImNvbnRhY3QiOnsiZW1haWwiOiJ7ZW1haWxBZGRyZXNzfSIsIm1vYmlsZSI6Inttb2JpbGVOdW1iZXJ9In19LCJwYXltZW50Ijp7ImRlc2NyaXB0aW9uIjoie3RyYW5zYWN0aW9uRGVzY3JpcHRpb259IiwiYW1vdW50IjoxMDAsImN1cnJlbmN5Ijoie2N1cnJlbmN5Q29kZX0iLCJvcHRpb24iOiJ7Z2VuZXJhdGVkT3B0aW9uS2V5fSIsIm1lcmNoYW50X3JlZmVyZW5jZV9pZCI6IntyZWZlcmVuY2V9Iiwib3RoZXJfcmVmZXJlbmNlcyI6WyJ7cmVmZXJlbmNlMX0iLCJ7cmVmZXJlbmNlMn0iXX0sInJvdXRlIjp7ImNhbGxiYWNrX3VybCI6IntjYWxsYmFja1VybH0iLCJub3RpZnlfdXNlciI6dHJ1ZX19fQ.21qPOEoXodlV_pmMe_7xvuH9QGLnyIcq0nmnj_8fwAc"
    }

Responses

200 Successful Response

400 Erroneous Response

Response Samples

200401

{
  "timestamp": "2021-06-13 06:52:37 +0000",
  "status": 200,
  "message": "OK",
  "path": "/disburse",
  "data": {
    "transactionReference": "210613065229SJF9939",
    "statusCode": "OK.00.10",
    "statusDescription": "Disbursement request successful"
  }
}

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