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 

"test@mail.com,user@mail.com"

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...

{
    "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": "testing@gmail.com",
    "idempotency_key": "TEST00983"
}
Body JSON
{
"account_number" : 4210343721,
"bank_code" : "bca",
"amount" : 20000,
"remark" : "testing",
"beneficiary_email" : "testing@gmail.com",
"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 --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" : "testing@gmail.com",
"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"
}'
PreviousCreate disbursementNextGet all disbursements

Last updated