# Transfer

Create a **signature** and use the **request header + request body**

## Transfer Payment

<mark style="color:green;">`POST`</mark> `https: //example.co.id/account/api/transfer`

This service is used for transfer from the partner's account to the destination account that has been registered previously

`*` means the parameter is **required (mandatory)**

#### Headers

<table><thead><tr><th width="237">Parameter</th><th width="93">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>faspay-key<mark style="color:red;">*</mark></td><td>String</td><td>Provide by faspay</td></tr><tr><td>faspay-timestamp<mark style="color:red;">*</mark></td><td>String</td><td>datetime (Y-m-d H:i:s)</td></tr><tr><td>faspay-signature<mark style="color:red;">*</mark></td><td>String</td><td>Signature please refer to <em>signature section</em></td></tr><tr><td>faspay-authorization<mark style="color:red;">*</mark></td><td>String</td><td>Encrypt method: AES 256 <strong><code>FASPAY_SECRET:APP_KEY:APP_SECRET)</code></strong></td></tr><tr><td>Content-Type<mark style="color:red;">*</mark></td><td>String</td><td><code>application/json</code></td></tr></tbody></table>

#### Request Body

{% tabs %}
{% tab title="Request parameter" %}

<table><thead><tr><th width="286">Parameter</th><th width="161">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>virtual_account<mark style="color:red;">*</mark></td><td>Number(20)</td><td>VA partner</td></tr><tr><td>beneficiary_virtual_account<mark style="color:red;">*</mark></td><td>Number(20)</td><td>VA number of beneficiary account</td></tr><tr><td>beneficiary_account<mark style="color:red;">*</mark></td><td>Number(128)</td><td>Account number of VA</td></tr><tr><td>beneficiary_name<mark style="color:red;">*</mark></td><td>String(255)</td><td>Account beneficiary name</td></tr><tr><td>beneficiary_bank_code<mark style="color:red;">*</mark></td><td>Number(3)</td><td>Beneficiary bank code</td></tr><tr><td>beneficiary_region_code<mark style="color:red;">*</mark></td><td>Number</td><td>Code of branch bank</td></tr><tr><td>beneficiary_country_code<mark style="color:red;">*</mark></td><td>String(2)</td><td>Code of country</td></tr><tr><td>beneficiary_purpose_code<mark style="color:red;">*</mark></td><td>Number(1)</td><td>Code of the purpose of using the system account</td></tr><tr><td>beneficiary_email</td><td>String</td><td><p>Beneficiary Email </p><p>Note: email can be filled in more than 1 by entering <code>,</code> for the separator</p></td></tr><tr><td>trx_no<mark style="color:red;">*</mark></td><td>Number</td><td>Transaction number from partner</td></tr><tr><td>trx_date<mark style="color:red;">*</mark></td><td>DateTime</td><td>datetime format (Y-m-d H:i:s)</td></tr><tr><td>instruct_date<mark style="color:red;">*</mark></td><td>DateTime</td><td>Instruct date is a date for transaction: <br>-<strong>Null</strong>: real-time transaction<br>-<strong>Datetime</strong>: ex 2018-12-21 08:30:00, the transaction will be sent at 2018-12-21 08:30:00</td></tr><tr><td>trx_amount<mark style="color:red;">*</mark></td><td>Integer</td><td>Total amount, ex : 10.000 -> 10000<strong>00</strong><br><strong>Writing format is not allowed decimal, only integers are allowed</strong></td></tr><tr><td>trx_desc<mark style="color:red;">*</mark></td><td>String</td><td>Transaction description.<br>- If the user input is more than 15 characters, it will be cut into 15 characters.<br>- If the user input is "fee", it will be rejected.</td></tr><tr><td>callback_url<mark style="color:red;">*</mark></td><td>String</td><td>URL for callback/notification, used to notify the partner.</td></tr></tbody></table>
{% endtab %}

{% tab title="Sample request" %}

```json
{  
  "virtual_account" : "9920015307",
  "beneficiary_virtual_account" : "9920015361",
  "beneficiary_account" : "10000006",
  "beneficiary_name" : "PT. Florist Lentera Abadi",
  "beneficiary_bank_code" : "014",
  "beneficiary_region_code" : "0391",
  "beneficiary_country_code" : "ID",
  "beneficiary_purpose_code" : "1",
  "beneficiary_email" : "johnnysuh@gmail.com, seosuhjohnny@gmail.com"
  "trx_no" : "87643666",
  "trx_date" : "2020-08-25 08:51:00",
  "instruct_date" : "",
  "trx_amount" : "2500000",
  "trx_desc" : "Transfer",
  "callback_url" : "https://dev2.faspay.co.id/account/api/callback"
}
```

{% endtab %}
{% endtabs %}

#### Response Body

{% tabs %}
{% tab title="Response parameter" %}

<table><thead><tr><th width="286">Parameter</th><th width="161">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>virtual_account<mark style="color:red;">*</mark></td><td>Number(20)</td><td>VA partner</td></tr><tr><td>beneficiary_virtual_account<mark style="color:red;">*</mark></td><td>Number(20)</td><td>VA number of beneficiary account</td></tr><tr><td>beneficiary_account<mark style="color:red;">*</mark></td><td>Number(128)</td><td>Account number of VA</td></tr><tr><td>beneficiary_name<mark style="color:red;">*</mark></td><td>String(255)</td><td>Account beneficiary name</td></tr><tr><td>beneficiary_bank_code<mark style="color:red;">*</mark></td><td>Number(3)</td><td>Beneficiary bank code</td></tr><tr><td>beneficiary_region_code<mark style="color:red;">*</mark></td><td>Number</td><td>Code of branch bank</td></tr><tr><td>beneficiary_country_code<mark style="color:red;">*</mark></td><td>String(2)</td><td>Code of country</td></tr><tr><td>beneficiary_purpose_code<mark style="color:red;">*</mark></td><td>Number(1)</td><td>Code of the purpose of using the system account</td></tr><tr><td>beneficiary_email</td><td>String</td><td><p>Beneficiary Email </p><p>Note: email can be filled in more than 1 by entering <code>,</code> for the separator</p></td></tr><tr><td>trx_no<mark style="color:red;">*</mark></td><td>Number</td><td>Transaction number from partner</td></tr><tr><td>trx_date<mark style="color:red;">*</mark></td><td>DateTime</td><td>datetime format (Y-m-d H:i:s)</td></tr><tr><td>instruct_date<mark style="color:red;">*</mark></td><td>DateTime</td><td>Instruct date is a date for transaction: <br>-<strong>Null</strong>: real-time transaction<br>-<strong>Datetime</strong>: ex 2018-12-21 08:30:00, the transaction will be sent at 2018-12-21 08:30:00</td></tr><tr><td>trx_amount<mark style="color:red;">*</mark></td><td>Integer</td><td>Total amount, ex : 10.000 -> 10000<strong>00</strong><br><strong>Writing format is not allowed decimal, only integers are allowed</strong></td></tr><tr><td>trx_desc<mark style="color:red;">*</mark></td><td>String</td><td>Transaction description.<br>- If the user input is more than 15 characters, it will be cut into 15 characters.<br>- If the user input is "fee", it will be rejected.</td></tr><tr><td>callback_url<mark style="color:red;">*</mark></td><td>String</td><td>URL for callback/notification, used to notify the partner.</td></tr><tr><td>trx_id*</td><td>Number</td><td>ID transaction of transfer</td></tr><tr><td>trx_reff*</td><td>String (128)</td><td>Reference of transaction number on system disbursement</td></tr><tr><td>status*</td><td>Numeric (1)</td><td>List of status transaction: <br>1 = On Process, <br>2 = Success,<br>4 = Failed, <br>5 = Reverse</td></tr><tr><td>message*</td><td>String</td><td>Message transaction</td></tr><tr><td>response_code*</td><td>Number (2)</td><td>Response code from bank (00 = success)</td></tr><tr><td>response_desc*</td><td>String (32)</td><td>Response desc from bank</td></tr></tbody></table>
{% endtab %}

{% tab title="Sample response" %}

```json
{
    "virtual_account": "9920015307",
    "beneficiary_virtual_account": "9920015361",
    "beneficiary_account": "10000006",
    "beneficiary_name": "PT. Florist lentera Abadi",
    "beneficiary_bank_code": "014",
    "beneficiary_region_code": "0391",
    "beneficiary_country_code": "ID",
    "beneficiary_purpose_code": "1",
    "beneficiary_email" : "johnnysuh@gmail.com, seosuhjohnny@gmail.com"
    "trx_no": "87643666",
    "trx_date": "2020-08-25 08:51:00",
    "instruct_date": "",
    "trx_amount": 2500000,
    "trx_desc": "Transfer",
    "callback_url": "https://dev2.faspay.co.id/account/api/callback",
    "trx_id": 6411,
    "trx_reff": "O4wgHmwglqpFAv-hZiu-_9999980300009258",
    "status": "1",
    "message": "On Process",
    "response_code": "00",
    "response_desc": "success"
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.faspay.co.id/merchant-integration/api-reference-1/sendme/transfer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.