---
description: create a common disbursement transaction
---

# Create special disbursement

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

<table><thead><tr><th>ATTRIBUTE</th><th width="149.33333333333331">TYPE</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td>account_number</td><td>Number</td><td>The account number of the recipient</td></tr><tr><td>bank_code</td><td>String</td><td>Bank code of the recipient bank . Example : bca (<mark style="color:blue;">case sensitive require</mark>)</td></tr><tr><td>amount</td><td>Number</td><td>The amount of money to be disbursed</td></tr><tr><td>remark</td><td>String</td><td>Remark to be included in the transfer made to the recipient. Usually will appear as <code>berita transfer</code> or <code>remark</code> in the transfer receipt. Max length for this attribute is <strong>18</strong> character</td></tr><tr><td>recipient_city</td><td>String (optional)</td><td>City code of the recipient city. Available value can be retrieved from <a href="https://doc.appgregator.co/appgregators/finance/flip-indonesia/sandbox/money-transfer/list-of-available-city">city list</a></td></tr><tr><td>beneficiary_email</td><td>String</td><td><p>List of the recipient emails (separated by comma). Example </p><pre><code>"test@mail.com,user@mail.com"
</code></pre><p> </p></td></tr><tr><td>sender_country</td><td>Number</td><td><p>Country code of the sender’s residence. Available value can be retrieved from country list </p><pre class="language-shell"><code class="lang-shell">{
    "100246": "West Africa",
    "100247": "Malagasi",
    "100248": "Korea Utara",
    "100249": "Ivory Coast",
    "100250": "International Institution",
    "100251": "Others",
    "100252": "Indonesia"
  ...
}
</code></pre></td></tr><tr><td></td><td></td><td></td></tr><tr><td>sender_place_of_birth</td><td>Number</td><td><p>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{</p><pre class="language-shell"><code class="lang-shell">{
    "100246": "West Africa",
    "100247": "Malagasi",
    "100248": "Korea Utara",
    "100249": "Ivory Coast",
    "100250": "International Institution",
    "100251": "Others",
    "100252": "Indonesia"
  ...
}
</code></pre></td></tr><tr><td>sender_date_of_birth</td><td>Date</td><td>Sender’s date of birth with <code>YYYY-MM-DD</code> format</td></tr><tr><td>sender_identity_type</td><td>String</td><td><p></p><p>Sender’s ID type. Accepted value are:<br></p><ul><li><code>nat_id</code><br>National Id Card or KTP in Indonesia</li><li><code>drv_lic</code><br>Driving license</li><li><code>passport</code></li><li><code>bank_acc</code><br>Bank Account (<code>DEFAULT</code>)</li></ul></td></tr><tr><td>sender_name</td><td>String</td><td>The name of the user of the Money Transfer Company that act as a sender</td></tr><tr><td>sender_address</td><td>String</td><td>Sender’s address</td></tr><tr><td>sender_identity_number</td><td>Number</td><td>Sender’s ID number. Default value is from attribute <code>account_number</code></td></tr><tr><td>sender_job</td><td>String</td><td><p></p><p>Sender’s job. Accepted values are:<br></p><ul><li><code>housewife</code></li><li><code>entrepreneur</code></li><li><code>private_employee</code></li><li><code>government_employee</code></li><li><code>foundation_board</code><br>People who work at foundation as an employee</li><li><code>indonesian_migrant_worker</code><br>Also known as TKI</li><li><code>company</code><br>If sender is a company, not individual</li><li><code>others</code></li></ul></td></tr><tr><td>direction</td><td>String</td><td><p></p><p>The direction of the transaction. Accepted values are:<br></p><ul><li><code>DOMESTIC_SPECIAL_TRANSFER</code><br>When the sender and the recipient are both residing in Indonesia</li><li><code>FOREIGN_INBOUND_SPECIAL_TRANSFER</code><br>When the sender are in a foreign country, but the recipient are in Indonesia</li></ul></td></tr><tr><td>idempotency_key</td><td>String</td><td>your key</td></tr></tbody></table>



<mark style="color:green;">`POST`</mark> `https://us-central1-appgregator.cloudfunctions.net/flipSandbox/special-disbursement/create/`

#### Query Parameters

| Name                                               | Type   | Description  |
| -------------------------------------------------- | ------ | ------------ |
| name<mark style="color:red;">\*</mark>             | String | ft-4         |
| connection\_name<mark style="color:red;">\*</mark> | String | flip-entre-1 |

#### Headers

| Name                                        | Type   | Description |
| ------------------------------------------- | ------ | ----------- |
| x-api-key<mark style="color:red;">\*</mark> | String | U2FsdGVk... |

{% tabs %}
{% tab title="201: Created Success" %}
```javascript
{
    "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"
}
```
{% endtab %}

{% tab title="400: Bad Request Bad request" %}
```javascript
Request failed with status code 422
```
{% endtab %}
{% endtabs %}

<details>

<summary>Body JSON</summary>

```shell
{
"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"
}
```

</details>

{% tabs %}
{% tab title="cURL" %}
```shell
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"
}'
```
{% endtab %}

{% tab title="NodeJs - Axios" %}
```javascript
var axios = require('axios');
var data = JSON.stringify({
  "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": "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);
});

```
{% endtab %}

{% tab title="PHP - cURL" %}
```php
<?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" : "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" : "TEST007"
}',
  CURLOPT_HTTPHEADER => array(
    'x-api-key: U2FsdG...',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

```
{% endtab %}
{% endtabs %}
