Create special disbursement

create a common disbursement transaction

Special Money Transfer is a type of disbursement for a company operating as a Money Transfer Company (Perusahaan Transfer Dana). The difference with common disbursement, is in this transaction you must provide your senders personal information as part of the Know Your Customer (KYC) process mandated by Bank Indonesia.

Attributes

ATTRIBUTE	TYPE	DESCRIPTION
account_number	Number	The account number of the recipient
bank_code	String	Bank code of the recipient bank . Example : bca (case sensitive require)
amount	Number	The amount of money to be disbursed
remark	String	Remark to be included in the transfer made to the recipient. Usually will appear as berita transfer or remark in the transfer receipt. Max length for this attribute is 18 character
recipient_city	String (optional)	City code of the recipient city. Available value can be retrieved from city list
beneficiary_email	String	List of the recipient emails (separated by comma). Example "[e-mail],[e-mail]"
sender_country	Number	Country code of the sender’s residence. Available value can be retrieved from country list { "100246": "West Africa", "100247": "Malagasi", "100248": "Korea Utara", "100249": "Ivory Coast", "100250": "International Institution", "100251": "Others", "100252": "Indonesia" ... }
sender_place_of_birth	Number	City/country code of the sender’s place of birth. Use city code if the sender’s place of birth is in Indonesia, and country code if outside Indonesia. Available value can be retrieved from city/country list{ { "100246": "West Africa", "100247": "Malagasi", "100248": "Korea Utara", "100249": "Ivory Coast", "100250": "International Institution", "100251": "Others", "100252": "Indonesia" ... }
sender_date_of_birth	Date	Sender’s date of birth with YYYY-MM-DD format
sender_identity_type	String	Sender’s ID type. Accepted value are: nat_id National Id Card or KTP in Indonesia drv_lic Driving license passport bank_acc Bank Account (DEFAULT)
sender_name	String	The name of the user of the Money Transfer Company that act as a sender
sender_address	String	Sender’s address
sender_identity_number	Number	Sender’s ID number. Default value is from attribute account_number
sender_job	String	Sender’s job. Accepted values are: housewife entrepreneur private_employee government_employee foundation_board People who work at foundation as an employee indonesian_migrant_worker Also known as TKI company If sender is a company, not individual others
direction	String	The direction of the transaction. Accepted values are: DOMESTIC_SPECIAL_TRANSFER When the sender and the recipient are both residing in Indonesia FOREIGN_INBOUND_SPECIAL_TRANSFER When the sender are in a foreign country, but the recipient are in Indonesia
idempotency_key	String	your key

POST https://us-central1-appgregator.cloudfunctions.net/flipSandbox/special-disbursement/create/

Query Parameters

Name	Type	Description
name*	String	ft-4
connection_name*	String	flip-entre-1

Headers

Name	Type	Description
x-api-key*	String	U2FsdGVk...

201: Created Success

{
    "id": 58999,
    "user_id": 423304,
    "amount": 20000,
    "status": "PENDING",
    "reason": "",
    "timestamp": "2022-12-08 10:35:44",
    "bank_code": "bca",
    "account_number": "4210343721",
    "recipient_name": "",
    "sender_bank": "bca",
    "remark": "testing",
    "receipt": "",
    "time_served": "(not set)",
    "bundle_id": 0,
    "company_id": 5770,
    "recipient_city": 109,
    "created_from": "API",
    "direction": "DOMESTIC_SPECIAL_TRANSFER",
    "sender": {
        "sender_name": "https://example.com/flip/callback/JU001",
        "sender_place_of_birth": 391,
        "sender_date_of_birth": "1992-01-01",
        "sender_address": "-",
        "sender_identity_type": "nat_id",
        "sender_identity_number": "123456789",
        "sender_country": 100252,
        "sender_job": "entrepreneur"
    },
    "fee": 2200,
    "beneficiary_email": "[e-mail]",
    "idempotency_key": "TEST00983"
}

400: Bad Request Bad request

Request failed with status code 422

Body JSON

{
"account_number" : 4210343721,
"bank_code" : "bca",
"amount" : 20000,
"remark" : "testing",
"beneficiary_email" : "[e-mail]",
"recipient_city" : "109",
"sender_country":"100252", 
"sender_place_of_birth" : "391",
"sender_date_of_birth" : "1992-01-01",
"sender_identity_type": "nat_id",
"sender_name" : "https://example.com/flip/callback/JU002",
"sender_address" : "-",
"sender_identity_number" : "123456789",
"sender_job" : "entrepreneur",
"direction" :"DOMESTIC_SPECIAL_TRANSFER",
"idempotency_key" : "TEST006"
}

cURL

curl --location --request POST 'https://us-central1-appgregator.cloudfunctions.net/flipSandbox/special-disbursement/create?name=ft-4&connection_name=flip-entre-1' \
--header 'x-api-key: U2Fsd...' \
--header 'Content-Type: application/json' \
--data-raw '{
"account_number" : 4210343721,
"bank_code" : "bca",
"amount" : 20000,
"remark" : "testing",
"beneficiary_email" : "[e-mail]",
"recipient_city" : "109",
"sender_country":"100252", 
"sender_place_of_birth" : "391",
"sender_date_of_birth" : "1992-01-01",
"sender_identity_type": "nat_id",
"sender_name" : "https://example.com/flip/callback/",
"sender_address" : "-",
"sender_identity_number" : "123456789",
"sender_job" : "entrepreneur",
"direction" :"DOMESTIC_SPECIAL_TRANSFER",
"idempotency_key" : "TEST006"
}'

NodeJs - Axios

var axios = require('axios');
var data = JSON.stringify({
  "account_number": 4210343721,
  "bank_code": "bca",
  "amount": 20000,
  "remark": "testing",
  "beneficiary_email": "[e-mail]",
  "recipient_city": "109",
  "sender_country": "100252",
  "sender_place_of_birth": "391",
  "sender_date_of_birth": "1992-01-01",
  "sender_identity_type": "nat_id",
  "sender_name": "https://example.com/flip/callback/",
  "sender_address": "-",
  "sender_identity_number": "123456789",
  "sender_job": "entrepreneur",
  "direction": "DOMESTIC_SPECIAL_TRANSFER",
  "idempotency_key": "TEST007"
});

var config = {
  method: 'post',
  url: 'https://us-central1-appgregator.cloudfunctions.net/flipSandbox/special-disbursement/create?name=ft-4&connection_name=flip-entre-1',
  headers: { 
    'x-api-key': 'U2FsdG...', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

PHP - cURL

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://us-central1-appgregator.cloudfunctions.net/flipSandbox/special-disbursement/create?name=ft-4&connection_name=flip-entre-1',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
"account_number" : 4210343721,
"bank_code" : "bca",
"amount" : 20000,
"remark" : "testing",
"beneficiary_email" : "[e-mail]",
"recipient_city" : "109",
"sender_country":"100252", 
"sender_place_of_birth" : "391",
"sender_date_of_birth" : "1992-01-01",
"sender_identity_type": "nat_id",
"sender_name" : "https://example.com/flip/callback/",
"sender_address" : "-",
"sender_identity_number" : "123456789",
"sender_job" : "entrepreneur",
"direction" :"DOMESTIC_SPECIAL_TRANSFER",
"idempotency_key" : "TEST007"
}',
  CURLOPT_HTTPHEADER => array(
    'x-api-key: U2FsdG...',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;