# SNAP Disbursement

## API Services

### Header

<table><thead><tr><th width="205">Field</th><th width="117">Attribute</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>Content-Type</td><td>Mandatory</td><td>String</td><td>application/json</td></tr><tr><td>X-TIMESTAMP</td><td>Mandatory</td><td>String</td><td>Client's current local time in yyyy-MM-ddTHH:mm:ssTZD format</td></tr><tr><td>X-SIGNATURE</td><td>Mandatory</td><td>String</td><td><p>Represents signature of a request.</p><p>Signature details <a href="https://docs.faspay.co.id/merchant-integration/api-reference-1/snap/signature-snap">here</a>.</p></td></tr><tr><td>ORIGIN</td><td>Optional</td><td>String</td><td>Origin Domain www.yourdomain.com</td></tr><tr><td>X-PARTNER-ID</td><td>Mandatory</td><td>String (5)</td><td>Unique ID for a partner</td></tr><tr><td>X-EXTERNAL- ID</td><td>Mandatory</td><td>String (36)</td><td>Numeric String. Reference number that should be unique in the same day</td></tr><tr><td>CHANNEL-ID</td><td>Mandatory</td><td>String (5)</td><td>Channel identifier using Faspay’s API Service (88001)</td></tr></tbody></table>

#### Header Response

<table><thead><tr><th>Field</th><th width="115">Attribute</th><th width="130">Type</th><th>Description</th></tr></thead><tbody><tr><td>Content-Type</td><td>Mandatory</td><td>String</td><td>application/json</td></tr><tr><td>X-TIMESTAMP</td><td>Mandatory</td><td>String</td><td>Client's current local time in yyyy-MM-ddTHH:mm:ssTZD format</td></tr></tbody></table>

{% tabs %}
{% tab title="Header Sample Request" %}

```json
Content-type: application/json
X-TIMESTAMP: 2020-12-17T10:55:00+07:00
X-SIGNATURE: 
85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
ORIGIN: www.hostname.com
X-PARTNER-ID: 82150
X-EXTERNAL-ID: 41807553358950093184162180797837
CHANNEL-ID: 88001
```

{% endtab %}

{% tab title="Header Sample Response" %}

```json
Content-type: application/json
X-TIMESTAMP: 2020-12-21T10:30:34+07:00
```

{% endtab %}
{% endtabs %}

### Account Inquiry

<mark style="color:green;">`POST`</mark> `/{version}/account-inquiry-external`

The Account Inquiry API is used to obtain the recipient's account information and to minimize the possibility of incorrect transfer destinations.

{% hint style="info" %}
Service code: 16

Current version: v1.0 \ <mark style="color:red;">\*</mark> is required
{% endhint %}

**URL Path**

> Sandbox:&#x20;
>
> `https://sendme-sandbox.faspay.co.id/account/v1.0/account-inquiry-external`&#x20;

#### Request Body

<table><thead><tr><th width="255">Parameter</th><th width="151">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>beneficiaryBankCode<mark style="color:red;">*</mark></td><td>String (8)</td><td>Beneficiary Bank Code</td></tr><tr><td>beneficiaryAccountNo<mark style="color:red;">*</mark></td><td>String (34)</td><td>Beneficiary Account Number</td></tr><tr><td>partnerReferenceNo</td><td>String (64)</td><td>Transaction identifier on partner’s system</td></tr><tr><td>additionalInfo<mark style="color:red;">*</mark></td><td>Object</td><td>Additional information</td></tr><tr><td>   sourceAccount<mark style="color:red;">*</mark></td><td>String (10)</td><td>Source account number (Sendme virtual account number)</td></tr></tbody></table>

#### Response

<table><thead><tr><th width="255">Parameter</th><th width="153">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>responseCode<mark style="color:red;">*</mark></td><td>String (7)</td><td>Response code</td></tr><tr><td>responseMessage<mark style="color:red;">*</mark></td><td>String (150)</td><td>Response description</td></tr><tr><td>referenceNo<mark style="color:red;">*</mark></td><td>String (64)</td><td>Transaction identifier on faspay’s system. Must be filled upon successful transaction</td></tr><tr><td>partnerReferenceNo<mark style="color:red;">*</mark></td><td>String (64)</td><td>Transaction identifier on partner's system</td></tr><tr><td>beneficiaryAccountName<mark style="color:red;">*</mark></td><td>String (100)</td><td>Beneficiary Account Name</td></tr><tr><td>beneficiaryAccountNo<mark style="color:red;">*</mark></td><td>String (20)</td><td>Beneficiary Account Number</td></tr><tr><td>beneficiaryBankCode<mark style="color:red;">*</mark></td><td>String (8)</td><td>Beneficiary Bank Code</td></tr><tr><td>beneficiaryBankName<mark style="color:red;">*</mark></td><td>String (50)</td><td>Beneficiary Bank Name</td></tr><tr><td>currency</td><td>String (3)</td><td>Currency Type, default : IDR</td></tr><tr><td>additionalInfo<mark style="color:red;">*</mark></td><td>Object</td><td>Additional information</td></tr><tr><td>        status<mark style="color:red;">*</mark></td><td>String (1)</td><td>1 = Success</td></tr><tr><td>       message<mark style="color:red;">*</mark></td><td>String (50)</td><td>Message description</td></tr></tbody></table>

{% tabs %}
{% tab title="Account Inquiry-Sample Request" %}

```json
{
   "beneficiaryBankCode":"002",
   "beneficiaryAccountNo":"888801000157508",
   "partnerReferenceNo":"2020102900000000000001",
   "additionalInfo":{
       "sourceAccount":"9920000082"
}
}
```

{% endtab %}

{% tab title="Account Inquiry - Sample Response" %}

```json
{
    "responseCode": "2001600",
    "responseMessage": "Request has been processed successfully",
    "referenceNo": "2023082914320300000034",
    "partnerReferenceNo": "",
    "beneficiaryAccountName": "Budi",
    "beneficiaryAccountNo": "60004400184",
    "beneficiaryBankCode": "008",
    "beneficiaryBankName": "BANK MANDIRI",
    "currency": "IDR",
    "additionalInfo":
    {
        "status": "1",
        "message": "Success"
    }
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
**Notes**:&#x20;

When doing a **trigger transfe**r, always make at least one account inquiry you want to transfer first.
{% endhint %}

### Trigger Transfer – InterBank Transfer

<mark style="color:green;">`POST`</mark> `/account/{version}/transfer-interbank`

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

{% hint style="info" %}
Service code: 18\
Current version: v1.0 \ <mark style="color:red;">\*</mark> is required
{% endhint %}

**URL Path**

> Sandbox:&#x20;
>
> `https://sendme-sandbox.faspay.co.id/account/v1.0/transfer-interbank`

#### Request Body

<table><thead><tr><th width="252">Parameter</th><th width="153">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>partnerReferenceNo<mark style="color:red;">*</mark></td><td>String (64)</td><td>Transaction identifier on partner’s system</td></tr><tr><td>amount<mark style="color:red;">*</mark></td><td>Object</td><td></td></tr><tr><td>value<mark style="color:red;">*</mark></td><td>String (12,2)</td><td><p>Net amount of the transaction. <br><br><strong>Notes:</strong> </p><ul><li>If it’s IDR then value includes 2 decimal digits. e.g. IDR 10.000,- will be placed with 10000.00</li><li>Amount <strong>isn't allowed decimal</strong> <strong>other than 00</strong></li></ul></td></tr><tr><td>currency<mark style="color:red;">*</mark></td><td>String</td><td>Currency</td></tr><tr><td>beneficiaryAccountName<mark style="color:red;">*</mark></td><td>String (100)</td><td>Beneficiary Account Name</td></tr><tr><td>beneficiaryAccountNo<mark style="color:red;">*</mark></td><td>String (34)</td><td>Beneficiary Account</td></tr><tr><td>beneficiaryBankCode<mark style="color:red;">*</mark></td><td>String (3)</td><td>Beneficiary Bank Code</td></tr><tr><td>beneficiaryEmail</td><td>String (50)</td><td>Beneficiary Email</td></tr><tr><td>sourceAccountNo<mark style="color:red;">*</mark></td><td>String (10)</td><td><p>Source Account Number</p><p>(Sendme account number)</p></td></tr><tr><td>transactionDate<mark style="color:red;">*</mark></td><td>Date (25)</td><td><p>transaction date : ISO 8601</p><p>FORMAT: ‘yyyy-MM-dd’T’HH:mm:ssTZD’</p></td></tr><tr><td>additionalInfo<mark style="color:red;">*</mark></td><td>Object</td><td>Additional information</td></tr><tr><td>instructDate</td><td>Datetime</td><td><p>Instruct date is date for transaction</p><p> </p><p>ISO 8601</p><p>FORMAT: ‘yyyy-MM-dd’T’HH:mm:ssTZD’</p><p> </p><p>if <strong>Null/Empty,</strong> transaction will be processed immediately</p><p> </p><p>If filled then the transaction will be sent as date filled.</p></td></tr><tr><td>transactionDescription</td><td>String (15)</td><td>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>callbackUrl<mark style="color:red;">*</mark></td><td>String (255)</td><td>URL for callback / notification, used to notify the partner.</td></tr></tbody></table>

#### Response

<table><thead><tr><th width="249">Parameter</th><th width="153">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>responseCode<mark style="color:red;">*</mark></td><td>String (7)</td><td>Response code</td></tr><tr><td>responseMessage<mark style="color:red;">*</mark></td><td>String (150)</td><td>Response description</td></tr><tr><td>referenceNo<mark style="color:red;">*</mark></td><td>String (16)</td><td>Transaction identifier on faspay’s system. Must be filled upon successful transaction</td></tr><tr><td>partnerReferenceNo<mark style="color:red;">*</mark></td><td>String (64)</td><td>Transaction identifier on partner’s system</td></tr><tr><td>amount<mark style="color:red;">*</mark></td><td>Object</td><td> </td></tr><tr><td>      value<mark style="color:red;">*</mark></td><td>String (ISO4217) (12,2)</td><td>Net amount of the transaction</td></tr><tr><td>     currency<mark style="color:red;">*</mark></td><td>String (3)</td><td>Currency</td></tr><tr><td>beneficiaryAccountNo<mark style="color:red;">*</mark></td><td>String (19)</td><td>Beneficiary Account Number</td></tr><tr><td>beneficiaryBankCode<mark style="color:red;">*</mark></td><td>String (3)</td><td>Beneficiary Bank Code</td></tr><tr><td>sourceAccountNo<mark style="color:red;">*</mark></td><td>String (10)</td><td>Source Account Number</td></tr><tr><td>additionalInfo<mark style="color:red;">*</mark></td><td>Object</td><td>Additional information</td></tr><tr><td>   beneficiaryAccountName<mark style="color:red;">*</mark></td><td>String (100)</td><td>Beneficiary Account Name</td></tr><tr><td>     beneficiaryBankName<mark style="color:red;">*</mark></td><td>String (50)</td><td>Beneficiary bank name</td></tr><tr><td>     instructDate<mark style="color:red;">*</mark></td><td>DateTime (50)</td><td>Response of instruct date has been sent</td></tr><tr><td>     transactionDescription<mark style="color:red;">*</mark></td><td>String (15)</td><td>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>     callbackUrl<mark style="color:red;">*</mark></td><td>String (255)</td><td>URL for callback / notification, used to notify the partner.</td></tr><tr><td>   latestTransactionStatus<mark style="color:red;">*</mark></td><td>String (2)</td><td><p>00 - Success </p><p>01 - Initiated </p><p>02 - Paying </p><p>03 - Pending </p><p>04 - Refunded </p><p>05 - Canceled </p><p>06 - Failed </p><p>07 - Not found</p></td></tr><tr><td>   transactionStatusDesc<mark style="color:red;">*</mark></td><td>String (50)</td><td>Description status transaction</td></tr></tbody></table>

{% tabs %}
{% tab title="Trigger Transfer Inter Bank - Sample Request" %}

```json
{
   "partnerReferenceNo":"2020102900000000000001",
   "amount":{
      "value":"12345678.00",
      "currency":"IDR"
   },
   "beneficiaryAccountName":"Yories Yolanda",
   "beneficiaryAccountNo":"888801000003301",
   "beneficiaryBankCode":"002",
   "beneficiaryEmail":"yories.yolanda@work.bri.co.id",
   "sourceAccountNo":"888801000157508",
   "transactionDate":"2019-07-03T12:08:56-07:00",
   "additionalInfo":{
       "instructDate":"",
       "transactionDescription":"Transfer",
       "callbackUrl":"https://dev2.faspay.co.id/account/api/callback"
   }
}
```

{% endtab %}

{% tab title="Trigger Transfer Inter Bank - Sample Response" %}

<pre class="language-json"><code class="lang-json">{
   "responseCode":"2001800",
   "responseMessage":"Request has been processed successfully",
   "referenceNo":"2020102977770000000009",
   "partnerReferenceNo":"2020102900000000000001",
   "amount":{
      "value":"12345678.00",
      "currency":"IDR"
   },
   "beneficiaryAccountNo":"888801000003301",
   "beneficiaryBankCode":"002",
   "sourceAccountNo":"888801000157508",
   "additionalInfo":{
      "beneficiaryAccountName":"Yories Yolanda",
      "beneficiaryBankName":"BRI",
<strong>      "instructDate":"2019-07-03T12:08:56-07:00",
</strong>      "transactionDescription":"Transfer",
      "callbackUrl":"https://dev2.faspay.co.id/account/api/callback",
      "latestTransactionStatus":"03",
      "transactionStatusDesc":"Pending"
   }
}
</code></pre>

{% endtab %}
{% endtabs %}

### Transfer Status Inquiry Bank

<mark style="color:green;">`POST`</mark> `/account/{version}/transfer/status`

Partners use the Bank's Transfer Status Inquiry API to check the status of transfers made.

Service code: 36

Note:`*` is required

&#x20;         \- Current Version: v1.0

**URL Path**

Sandbox:&#x20;

`https://sendme-sandbox.faspay.co.id/account/v1.0/transfer/status`

#### Request Body

<table><thead><tr><th width="268">Parameter</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>originalPartnerReferenceNo<mark style="color:red;">*</mark></td><td>String (64)</td><td>Original transaction identifier on partner’s system</td></tr><tr><td>originalReferenceNo</td><td>String (16)</td><td>Original transaction identifier on Faspay’s system</td></tr><tr><td>serviceCode<mark style="color:red;">*</mark></td><td>String (2)</td><td>Use service code 18 to inquiry interbank transfer status.</td></tr></tbody></table>

#### Response Parameter – Transfer Status Inquiry Bank

<table><thead><tr><th width="282">Parameter</th><th width="111">Data Type</th><th width="119">M/O/C</th><th>Description</th></tr></thead><tbody><tr><td>responseCode</td><td>String (7)</td><td>Mandatory</td><td>Response code</td></tr><tr><td>responseMessage</td><td>String (150)</td><td>Mandatory</td><td>Response description</td></tr><tr><td>originalReferenceNo</td><td>String (16)</td><td>Conditional</td><td>Original transaction identifier on partner’s system. Must be filled upon successful transaction</td></tr><tr><td>originalPartnerReferenceNo</td><td>String (64)</td><td>Mandatory</td><td>Original transaction identifier on service consumer system</td></tr><tr><td>serviceCode</td><td>String (2)</td><td>Mandatory</td><td>Use service code 18 to inquiry interbank transfer status</td></tr><tr><td>transactionDate</td><td>Datetime (25)</td><td>Optional</td><td>transaction date : ISO 8601 FORMAT: ‘yyyy-MM-dd’T’HH:mm:ssTZD’</td></tr><tr><td>amount</td><td>Object</td><td>Optional</td><td></td></tr><tr><td>     value</td><td>String (ISO4217) (12,2)</td><td>Mandatory</td><td>Net amount of the transaction</td></tr><tr><td>     currency</td><td>String (3)</td><td>Mandatory</td><td>Currency</td></tr><tr><td>beneficiaryAccountNo</td><td>String (34)</td><td>Mandatory</td><td>Beneficiary Account</td></tr><tr><td>beneficiaryBankCode</td><td>String (3)</td><td>Optional</td><td>Beneficiary Bank Code</td></tr><tr><td>referenceNumber</td><td>String (30)</td><td>Optional</td><td>Reference Number from system</td></tr><tr><td>sourceAccountNo</td><td>String (10)</td><td>Mandatory</td><td>Source Account</td></tr><tr><td>latestTransactionStatus</td><td>String (2)</td><td>Mandatory</td><td><p>00 - Success </p><p>01 - Initiated </p><p>02 - Paying </p><p>03 - Pending </p><p>04 - Refunded </p><p>05 - Canceled </p><p>06 - Failed </p><p>07 - Not found</p></td></tr><tr><td>transactionStatusDesc</td><td>String (50)</td><td>Mandatory</td><td>Description status transaction</td></tr><tr><td>additionalInfo</td><td>Object</td><td>Mandatory</td><td>Additional information</td></tr><tr><td>      beneficiaryAccountName</td><td>String (128)</td><td>Mandatory</td><td>Account number of VA receiver</td></tr><tr><td>      beneficiaryBankName</td><td>String (128)</td><td>Mandatory</td><td>Beneficiary bank name</td></tr><tr><td>      transactionDescription</td><td>String (15)</td><td>Mandatory</td><td>Transaction description</td></tr><tr><td>      callbackUrl</td><td>String (255)</td><td>Mandatory</td><td>URL for callback / notification, used if the partner wants the system to notify the partner.</td></tr><tr><td>      transactionStatusDate</td><td>Datetime (25)</td><td>Mandatory</td><td>Transaction of success date ISO 8601 FORMAT: ‘yyyy-MM-dd’T’HH:mm:ssTZD</td></tr></tbody></table>

{% tabs %}
{% tab title="Request - Transfer Status Inquiry Bank" %}

```json
{
   "originalPartnerReferenceNo":"2020102900000000000001",
   "originalReferenceNo":"2020102977770000000009",
   "serviceCode":"18"
}

```

{% endtab %}

{% tab title="Response - Transfer Status Inquiry Bank" %}

<pre class="language-json"><code class="lang-json">{
   "responseCode":"2003600",
   "responseMessage":"Request has been processed successfully",
   "originalReferenceNo":"2020102977770000000009",
   "originalPartnerReferenceNo":"2020102900000000000001",
   "serviceCode":"18",
   "transactionDate":"2019-07-03T12:08:56-07:00",
   "amount":{
      "value":"12345678.00",
      "currency":"IDR"
   },
   "beneficiaryAccountNo":"888801000003301",
   "beneficiaryBankCode":"002",
   "referenceNumber":"10052019",
   "sourceAccountNo":"888801000157508",
   "latestTransactionStatus":"03",
   "transactionStatusDesc":"Pending",
   "additionalInfo":{
<strong>      "beneficiaryAccountName":"Yories Yolanda",
</strong><strong>      "beneficiaryBankName":"Bank BRI",
</strong>      "transactionDescription":"Transfer",
      "callbackUrl":" https://dev2.faspay.co.id/account/api/callback ",
      "transactionStatusDate":"2019-07-03T12:08:56-07:00"
   }
}
</code></pre>

{% endtab %}
{% endtabs %}

### Inquiry Balance

<mark style="color:green;">`POST`</mark> `/account/{version}/balance-inquiry`

Inquiry Balance API is used to check the balance of user accounts registered with Faspay SendMe.

Service Code: 11

Notes: `*` is required

&#x20;            \- Current Version: v1.0

**URL Path**

Sandbox:&#x20;

`https://sendme-sandbox.faspay.co.id/account/v1.0/balance-inquiry`

#### Request Body

| Parameter                                   | Data Type   | Description                     |
| ------------------------------------------- | ----------- | ------------------------------- |
| accountNo<mark style="color:red;">\*</mark> | String (10) | Partner’s Sendme Account number |

#### Response Parameter – Inquiry Balance

<table><thead><tr><th>Parameter</th><th width="143">Data Type</th><th width="129">M/O/C</th><th>Description</th></tr></thead><tbody><tr><td>responseCode</td><td>String (7)</td><td>Mandatory</td><td>Response code</td></tr><tr><td>responseMessage</td><td>String (150)</td><td>Mandatory</td><td>Response description</td></tr><tr><td>accountNo</td><td>String </td><td>Mandatory</td><td>Partner’s sendme account number</td></tr><tr><td>accountInfos</td><td>Array</td><td>Mandatory</td><td></td></tr><tr><td>      balanceType</td><td>String (70)</td><td>Optional </td><td>Account type name : “CASH”, “DEPOSIT”, “DEPOSIT BALANCE SETTLEMENT”</td></tr><tr><td>     amount</td><td>Object </td><td>Optional</td><td>Net amount of the transaction.</td></tr><tr><td>         value</td><td>String (12,2)</td><td>Mandatory</td><td><p></p><p>Net amount of the transaction</p></td></tr><tr><td>         currency</td><td>String (3)</td><td>Mandatory</td><td>Currency (IDR)</td></tr><tr><td>     availableBalance</td><td>Object</td><td>Mandatory</td><td>Account balance that can be used for financial transaction</td></tr><tr><td>        value</td><td>String (12,2)</td><td>Mandatory</td><td><p></p><p>Net amount of the transaction</p></td></tr><tr><td>       currency</td><td>String (3)</td><td>Mandatory</td><td>Currency (IDR)</td></tr><tr><td>     status</td><td>String (4)</td><td>Mandatory</td><td>Account Status <br>1 = Active Account <br>2 = Closed Account <br>4 = New Account <br>6 = Restricted Account <br>7 = Frozen Account <br>9 = Dormant Account</td></tr></tbody></table>

{% tabs %}
{% tab title="Request - Inquiry Balance Sample Code" %}

```json
{
   "accountNo":"7382382957893840"
}
```

{% endtab %}

{% tab title="Response - Inquiry Balance Sample Code" %}

```json
{
   "responseCode":"2001100",
   "responseMessage":"Request has been processed successfully",
   "accountNo":"115471119",
   "accountInfos":[
      {
         "balanceType":"CASH",
         "amount":{
            "value":"200000.00",
            "currency":"IDR"
         },
         "availableBalance":{
            "value":"130000.00",
            "currency":"IDR"
         },
         "status":"0001"
      },
      {
         "balanceType":"DEPOSIT",
         "amount":{
            "value":"200000.00",
            "currency":"IDR"
         },
         "availableBalance":{
            "value":"130000.00",
            "currency":"IDR"
         },
         "status":"0001"
      }
   ],
}

```

{% endtab %}
{% endtabs %}

### History List

<mark style="color:green;">`POST`</mark> `account/{version}/transaction-history-list`

API History List is used by users/partners to check transaction logs/account mutations registered in Faspay SendMe.

Service Code: 12

Notes: `*` is required

&#x20;            \- Current Version: v1.0

**URL Path**

Sandbox:&#x20;

`https://sendme-sandbox.faspay.co.id/account/v1.0/transaction-history-list`

#### Request Body

| Parameter                                        | Data Type                | Description                     |
| ------------------------------------------------ | ------------------------ | ------------------------------- |
| fromDateTime<mark style="color:red;">\*</mark>   | ISODateTimeISO-8601 (25) | Starting time range             |
| toDateTime<mark style="color:red;">\*</mark>     | ISODateTimeISO-8601 (25) | Ending time range.              |
| additionalInfo<mark style="color:red;">\*</mark> | Object                   | Additional information          |
| accountNo<mark style="color:red;">\*</mark>      | String (10)              | Partner’s sendme account number |

{% hint style="info" %}
Notes:&#x20;

*Maximum time span = 1 month*

*Oldest transaction history = 3 month*
{% endhint %}

#### Response - History List

<table><thead><tr><th width="247">Parameter</th><th width="150">Data Type</th><th width="119">M/O/C</th><th>Description</th></tr></thead><tbody><tr><td>responseCode</td><td>String (7)</td><td>Mandatory</td><td>Response code</td></tr><tr><td>responseMessage</td><td>String (150)</td><td>Mandatory</td><td>Response description</td></tr><tr><td>detailData</td><td>Array</td><td></td><td></td></tr><tr><td>   dateTime</td><td>ISODateTimeISO-860 (25)</td><td>Mandatory</td><td></td></tr><tr><td>   amount</td><td>Object</td><td>Mandatory</td><td></td></tr><tr><td>      value</td><td>Object</td><td>Mandatory</td><td>Net amount of the transaction</td></tr><tr><td>      currency</td><td>String (ISO4217) (3)</td><td>Mandatory</td><td>Currency</td></tr><tr><td>   remark</td><td>String (256)</td><td>Mandatory</td><td>Transaction remark.</td></tr><tr><td>   sourceOfFunds</td><td>List (N/A)</td><td>Mandatory</td><td>Source of funds used for this transaction.</td></tr><tr><td>      source</td><td>String (32)</td><td>Mandatory</td><td>Source of fund. = Available Balance</td></tr><tr><td>   status</td><td>String (2)</td><td>Mandatory</td><td><p>00 - Success </p><p>01 - Initiated </p><p>02 - Paying </p><p>03 - Pending </p><p>04 - Refunded </p><p>05 - Canceled </p><p>06 - Failed </p><p>07 - Not found</p></td></tr><tr><td>   type</td><td>String (32)</td><td>Mandatory</td><td>Transaction type. PAYMENT, REFUND, TOP_UP, SEND_MONEY, RECEIVE_MONEY</td></tr><tr><td>   additionalInfo</td><td>Object</td><td>Optional</td><td>Additional information from detailData</td></tr><tr><td>      debitCredit</td><td>String (1)</td><td>Mandatory</td><td><p>Transaction type : </p><p>D (Debit) </p><p>K (Kredit)</p></td></tr><tr><td>additionalInfo</td><td>Object</td><td>Mandatory</td><td>Additional information</td></tr><tr><td>   accountNo</td><td>String (10)</td><td>Mandatory</td><td>Partner’s account number</td></tr><tr><td>   fromDateTime</td><td>ISODateTimeISO-8601 (25)</td><td>Mandatory</td><td>Start date of inquiry mutation</td></tr><tr><td>   toDateTime</td><td>ISODateTimeISO-8601 (25)</td><td>Mandatory</td><td>End date of inquiry mutation</td></tr><tr><td>  message</td><td>String (50)</td><td>Mandatory</td><td>Description status transaction</td></tr></tbody></table>

{% tabs %}
{% tab title="Request - History List Sample Code" %}

```json
{
   "fromDateTime":"2025-06-12T13:44:50+07:00",
   "toDateTime":"2025-06-12T13:44:50+07:00",
   "additionalInfo":{
         "accountNo":"9920015307"
   }
}
```

{% endtab %}

{% tab title="Response - History List Sample Code" %}

```json
{
    "responseCode": "2001200",
    "responseMessage": "Request has been processed successfully",
    "detailData":
    [
        {
            "dateTime": "2025-06-12T13:44:50+07:00",
            "amount":
            {
                "value": "20000.00",
                "currency": "IDR"
            },
            "remark": "Reimburse 20250612 9920461912 OPJZka2Ga5mo1D6hwIw5",
            "sourceOfFunds":
            [
                {
                    "source": "BALANCE"
                }
            ],
            "status": "SUCCESS",
            "type": "SEND_MONEY",
            "additionalInfo":
            {
                "debitCredit": "D"
            }
        },
        {
            "dateTime": "2025-06-12T13:44:58+07:00",
            "amount":
            {
                "value": "1803.00",
                "currency": "IDR"
            },
            "remark": "fee 9920017564 OPJZka2Ga5mo1D6hwIw5_1749710686257450_149793_FEE",
            "sourceOfFunds":
            [
                {
                    "source": "BALANCE"
                }
            ],
            "status": "SUCCESS",
            "type": "PAYMENT",
            "additionalInfo":
            {
                "debitCredit": "D"
            }
        },
        {
            "dateTime": "2025-06-12T13:51:24+07:00",
            "amount":
            {
                "value": "20000.00",
                "currency": "IDR"
            },
            "remark": "Reimburse 20250612 9920461912 V3Bd64L2aAEzifkGFS2r_REVERSAL",
            "sourceOfFunds":
            [
                {
                    "source": "BALANCE"
                }
            ],
            "status": "SUCCESS",
            "type": "SEND_MONEY",
            "additionalInfo":
            {
                "debitCredit": "D"
            }
        },
        {
            "dateTime": "2025-06-12T13:51:31+07:00",
            "amount":
            {
                "value": "20000.00",
                "currency": "IDR"
            },
            "remark": "Reimburse 20250612 V3Bd64L2aAEzifkGFS2r",
            "sourceOfFunds":
            [
                {
                    "source": "BALANCE"
                }
            ],
            "status": "SUCCESS",
            "type": "SEND_MONEY",
            "additionalInfo":
            {
                "debitCredit": "K"
            }
        },
        {
            "dateTime": "2025-06-12T13:52:17+07:00",
            "amount":
            {
                "value": "20000.00",
                "currency": "IDR"
            },
            "remark": "Reimburse 20250612 MR55D6CHtnqQbIt3esJt",
            "sourceOfFunds":
            [
                {
                    "source": "BALANCE"
                }
            ],
            "status": "SUCCESS",
            "type": "SEND_MONEY",
            "additionalInfo":
            {
                "debitCredit": "K"
            }
        }
    ],
    "additionalInfo":
    {
        "accountNo": "9997617778",
        "fromDateTime": "2025-06-12T12:24:21+07:00",
        "toDateTime": "2025-06-12T14:03:21+07:00",
        "message": "Success"
    }
}
```

{% endtab %}
{% endtabs %}

### Customer Top Up

#### Flow Customer Top Up

<figure><img src="/files/7boh0Zbd2gTOS8OXWmCd" alt=""><figcaption></figcaption></figure>

<mark style="color:green;">`POST`</mark> `/account/{version}/emoney/topup`

The Customer Top-Up API is used by users/partners to transfer funds to e-wallets.

Service Code: 38

Notes: `*` is required

&#x20;            \- Customer Version: v1.0&#x20;

**URL Path**

Sandbox:&#x20;

`https://sendme-sandbox.faspay.co.id/account/v1.0/emoney/topup`

#### Request Body

| Parameter                                            | Data Type                 | Description                                                                                                                                                                                                                                                                        |
| ---------------------------------------------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| partnerReferenceNo<mark style="color:red;">\*</mark> | String (64)               | Transaction identifier on partner’s system                                                                                                                                                                                                                                         |
| customerNumber<mark style="color:red;">\*</mark>     | String (32)               | Beneficiary Account number                                                                                                                                                                                                                                                         |
| amount<mark style="color:red;">\*</mark>             | Object                    |                                                                                                                                                                                                                                                                                    |
| value<mark style="color:red;">\*</mark>              | String (ISO4217) (12,2)   | <p></p><p>Net amount of the transaction<br><br><strong>Notes:</strong> </p><ul><li>If it’s IDR then value includes 2 decimal digits. e.g. IDR 10.000,- will be placed with 10000.00</li><li>Amount <strong>isn't allowed decimal</strong> <strong>other than 00</strong></li></ul> |
| currency<mark style="color:red;">\*</mark>           | String (3)                | Currency                                                                                                                                                                                                                                                                           |
| transactionDate                                      | ISODateTime ISO-8601 (25) | <p>Transaction date</p><p> </p><p>ISO-8601</p><p>FORMAT: ‘yyyy-MM-dd’T’HH:mm:ssTZD’</p>                                                                                                                                                                                            |
| additionalInfo<mark style="color:red;">\*</mark>     | Object                    | Additional information                                                                                                                                                                                                                                                             |
| sourceAccount<mark style="color:red;">\*</mark>      | String (10)               | Partner’s source account                                                                                                                                                                                                                                                           |
| platformCode<mark style="color:red;">\*</mark>       | String (3)                | <p>Beneficiary bank code:</p><p>ovo = ovo</p><p>gpy = GoPay</p><p>dna = DANA</p><p>lkj = LinkAja</p>                                                                                                                                                                               |
| instructDate                                         | ISODateTimeISO-8601 (25)  | <p>Instruct date is a date for the transaction</p><p> </p><p>ISO 8601</p><p>FORMAT: ‘yyyy-MM-dd’T’HH:mm:ssTZD’<br><br>if <strong>Null</strong> transaction will be processed immediately</p><p> </p><p>If filled then the transaction will be sent as date filled.<br></p>         |
| beneficiaryEmail                                     | String (128)              | Beneficiary email                                                                                                                                                                                                                                                                  |
| transactionDescription                               | String (15)               | Transaction description                                                                                                                                                                                                                                                            |
| callbackUrl<mark style="color:red;">\*</mark>        | String (255)              | URL for callback / notification, used if the partner wants the system to send notifications to the partner                                                                                                                                                                         |

#### Response - Customer Top Up

<table><thead><tr><th width="263">Parameter</th><th width="159">Data Type</th><th width="120">M/O/C</th><th>Description</th></tr></thead><tbody><tr><td>responseCode</td><td>String (7)</td><td>Mandatory</td><td>Response code</td></tr><tr><td>responseMessage</td><td>String (150)</td><td>Mandatory</td><td>Response description</td></tr><tr><td>referenceNo</td><td>String (16)</td><td>Mandatory</td><td>Transaction identifier on Faspay’s system. Must be filled upon successful transaction</td></tr><tr><td>partnerReferenceNo</td><td>String (64)</td><td>Mandatory</td><td>Transaction identifier on Partner's system</td></tr><tr><td>customerNumber</td><td>String (64)</td><td>Mandatory</td><td>Beneficiary account number</td></tr><tr><td>amount</td><td>Object</td><td>Mandatory</td><td></td></tr><tr><td>      value</td><td>String (ISO4217) (12,2)</td><td>Mandatory</td><td>Net amount of the transaction</td></tr><tr><td>       currency</td><td>String (3)</td><td>Mandatory</td><td>Currency</td></tr><tr><td>additionalInfo</td><td>Object</td><td>Mandatory</td><td>Additional information</td></tr><tr><td>      sourceAccount</td><td>String (10)</td><td>Mandatory</td><td>Source account number</td></tr><tr><td>      platformCode</td><td>String (3)</td><td>Mandatory</td><td><p>Beneficiary bank code: </p><p>ovo = ovo </p><p>gpy = GoPay </p><p>dna = DANA </p><p>lkj = LinkAja</p></td></tr><tr><td>      beneficiaryEmail</td><td>String (128)</td><td>Optional</td><td>Beneficiary email</td></tr><tr><td>      transactionDate</td><td>ISODateTime ISO-8601 (25)</td><td>Mandatory</td><td><p>Transaction date </p><p>ISO-8601 </p><p></p><p>FORMAT: ‘yyyy-MM-dd’T’HH:mm:ssTZD’</p></td></tr><tr><td>     instructDate</td><td>ISODateTime ISO-8601 (25)</td><td>Mandatory</td><td>Transfer instruction date from request</td></tr><tr><td>     transactionDescription</td><td>String (255)</td><td>Mandatory</td><td>Transaction notes</td></tr><tr><td>     transactionReference</td><td>String (64)</td><td>Mandatory</td><td>Reference of transaction number on system disbursement</td></tr><tr><td>     callbackUrl</td><td>String (255)</td><td>Mandatory</td><td>URL for callback / notification, used if the partner wants the system to send notifications to the partner</td></tr><tr><td>     latestTransactionStatus</td><td>String (2)</td><td>Mandatory</td><td><p>00 - Success </p><p>01 - Initiated </p><p>02 - Paying </p><p>03 - Pending </p><p>04 - Refunded </p><p>05 - Canceled </p><p>06 - Failed </p><p>07 - Not found</p></td></tr><tr><td>     transactionStatusDesc</td><td>String (50)</td><td>Mandatory</td><td>Description status transaction</td></tr></tbody></table>

{% tabs %}
{% tab title="Request - Customer Top-Up Sample Code" %}

```json
{
   "partnerReferenceNo":"2020102900000000000001",
   "customerNumber":"6281773628883",
   "amount":{
      "value":"12345678.00",
      "currency":"IDR"
   },
   "transactionDate":"2020-12-21T17:01:11+07:00",
   "additionalInfo":{
      "sourceAccount":"9920011089",
      "platformCode":"ovo",
      "instructDate":"",
      "beneficiaryEmail":"john.doe@faspay.co.id",
      "trxDescription":"Transfer",
      "callbackUrl":""http://account-service/account/api/mail/sendtotele"
   }
}
```

{% endtab %}

{% tab title="Response - Customer Top-Up Sample Code" %}

<pre class="language-json"><code class="lang-json">{
   "responseCode":"2003800",
   "responseMessage":"Request has been processed successfully",
   "referenceNo":"2020102977770000000009",
   "partnerReferenceNo":"2020102900000000000001",
   "customerNumber":"628187366363",
   "amount":{
      "value":"12345678.00",
      "currency":"IDR"
   },
   "additionalInfo":{
<strong>      "sourceAccount":"9920011089",
</strong>      "platformCode":"ovo",
      "beneficiaryEmail":"john.doe@faspay.co.id",
      "transactionDate":"2020-12-21T17:01:11+07:00",
      "instructDate":"",
<strong>      "transactionDescription":"Transfer",
</strong>      "callbackUrl":"http://abc.com/account/api/mail/sendtotele",
      "transactionReference":"O4wgHmwglqpFAv-hZiu-_9999980300009258",
      "latestTransactionStatus":"03",
      "transactionStatusDesc":"Pending"
   }
}

</code></pre>

{% endtab %}
{% endtabs %}

### Customer Top-Up - Inquiry Status

<mark style="color:green;">`POST`</mark> `/{version}/emoney/topup-status`

This API is used by partners to check the status of top-up.

Service Code: 39

Note: `*` is required

&#x20;          \- Current Version: v1.0&#x20;

**URL Path**\
Sandbox:

`https://sendme-sandbox.faspay.co.id/account/v1.0/emoney/topup-status`

#### Request Body

| Name                                                         | Type        | Description                                            |
| ------------------------------------------------------------ | ----------- | ------------------------------------------------------ |
| originalPartnerReferenceNo<mark style="color:red;">\*</mark> | String (64) | Transaction identifier/reference generated by partner. |
| originalReferenceNo                                          | String (16) | Transaction identifier/reference generated by Faspay.  |
| serviceCode<mark style="color:red;">\*</mark>                | String (2)  | Use service code 38 to inquiry top up status           |

#### Response Customer Top Up - Inquiry Status

<table><thead><tr><th width="262">Parameter</th><th width="158">Data Type</th><th width="131">M/O/C</th><th>Descriptions</th></tr></thead><tbody><tr><td>responseCode</td><td>String (7)</td><td>Mandatory</td><td>Response code</td></tr><tr><td>responseMessage</td><td>String (150)</td><td>Mandatory</td><td>Response description</td></tr><tr><td>originalPartnerReferenceNo</td><td>String (64)</td><td>Mandatory</td><td>Transaction identifier/reference generated by partner</td></tr><tr><td>originalReferenceNo</td><td>String (16)</td><td>Mandatory</td><td>Transaction identifier/reference generated by Faspay.</td></tr><tr><td>serviceCode</td><td>String (2)</td><td>Mandatory</td><td>To identify which transaction that needs to be checked.</td></tr><tr><td>amount</td><td>Object</td><td>Mandatory</td><td></td></tr><tr><td>     value</td><td>String (ISO4217)<br>(12,2)</td><td>Mandatory</td><td>Net amount of the transaction</td></tr><tr><td>     currency</td><td>String (3)</td><td>Mandatory</td><td>Currency</td></tr><tr><td>latestTransactionStatus</td><td>String (2)</td><td>Mandatory</td><td><p>00 - Success </p><p>01 - Initiated </p><p>02 - Paying </p><p>03 - Pending </p><p>04 - Refunded </p><p>05 - Canceled </p><p>06 - Failed </p><p>07 - Not found</p></td></tr><tr><td>transactionStatusDesc</td><td>String (50)</td><td>Mandatory</td><td>Description status transaction</td></tr><tr><td>additionalInfo</td><td>Object</td><td>Mandatory</td><td>Additional information</td></tr><tr><td>     sourceAccount</td><td>String (10)</td><td>Mandatory</td><td>Partner’s source account</td></tr><tr><td>     transactionDate</td><td>ISODateTime ISO-8601 (25)</td><td>Mandatory</td><td><p>Transaction date<br>: ISO 8601</p><p> </p><p>FORMAT: ‘yyyy-MM-dd’T’HH:mm:ssTZD’</p></td></tr><tr><td>     platformCode</td><td>String (3)</td><td>Mandatory</td><td>Beneficiary Platform code</td></tr><tr><td>     platformName</td><td>String (50)</td><td>Mandatory</td><td>Beneficiary platform name</td></tr><tr><td>     customerNumber</td><td>String (64)</td><td>Mandatory</td><td>Beneficiary Account Number</td></tr><tr><td>     customerName</td><td>String (255)</td><td>Mandatory</td><td>Customer account name</td></tr><tr><td>     transactionDescription</td><td>String (255)</td><td>Mandatory</td><td>Description of transaction</td></tr><tr><td>     callbackUrl</td><td>String (255)</td><td>Mandatory</td><td>URL for callback/notification, used if the partner wants the system to notify the partner.</td></tr><tr><td>     transactionStatusDate</td><td>ISODateTime ISO-8601 (25)</td><td> Mandatory</td><td>Transaction of success date : ISO 8601 FORMAT: ‘yyyy-MM-dd’T’HH:mm:ssTZD’</td></tr></tbody></table>

{% tabs %}
{% tab title="Request - Customer Top Up - Inquiry Status" %}

```json
{
   "originalPartnerReferenceNo":"2021072342358089475892734",
   "originalReferenceNo":"2021072342358089475892091",
   "serviceCode":"38"
}
```

{% endtab %}

{% tab title="Response - Customer Top Up - Inquiry Status" %}

```json
{
   "responseCode":"2003900",
   "responseMessage":"Request has been processed successfully",
   "originalPartnerReferenceNo":"2021072342358089475892734",
   "originalReferenceNo":"2021072342358089475892091",
   "serviceCode":"38",
   "amount":{
      "value":"12345678.00",
      "currency":"IDR"
   },
   "latestTransactionStatus":"03",
   "transactionStatusDesc":"Pending",
   "additionalInfo":{
      "sourceAccount":"9920017573",
      "transactionDate":"2020-12-21T17:01:11+07:00",
      "platformCode":"gpy",
      "platformName":"Gopay",
      "customerNumber":"9998877766",
      "customerName":"Felicia",
      "transactionDescription":"Transfer",
      "callbackUrl":" http://abc.com/account/api/mail/sendtotele",
      "transactionStatusDate":"2020-12-21T17:01:11+07:00"
   }
}

```

{% endtab %}
{% endtabs %}

### Bill Payment

This API is used to utilities Bill Payment transactions Services in SNAP Disbursement API.

#### Flow Bill Payment

This are the flow process Bill Payment transactions in SNAP Disbursement API.

<figure><img src="/files/eWMzAvNhFIjF2zrzz8Qk" alt=""><figcaption></figcaption></figure>

#### Inquiry Bill Payment to VA from Intrabank

This API is used to inquiry the Bill Payment transaction.

<table data-header-hidden><thead><tr><th width="152"></th><th></th></tr></thead><tbody><tr><td><strong>URL Path</strong></td><td>.../{version}/transfer-va/inquiry-intrabank</td></tr><tr><td><strong>Method</strong></td><td>POST</td></tr><tr><td><strong>Channel Code</strong></td><td>32</td></tr></tbody></table>

#### &#x20;Request Parameter – Inquiry Bill Payment to VA Intrabank

The parameter that must be provide by the  partner system to be accessed by the Faspay system are as follows:

<table><thead><tr><th width="245">Parameter </th><th width="107">M/O/C</th><th width="130">Data Type</th><th width="86">Length</th><th>Description </th></tr></thead><tbody><tr><td>partnerReferenceNo </td><td>O</td><td>String</td><td>64</td><td>Unique identifier for this Payment. Generated by Partner </td></tr><tr><td>partnerServiceId </td><td>M</td><td>String</td><td>8</td><td>Company code, 8 digit left padding space </td></tr><tr><td>customerNo </td><td>M</td><td>String</td><td>20</td><td>Unique customer number (up to 20 digits) </td></tr><tr><td>virtualAccountNo </td><td>M</td><td>String</td><td>28</td><td>Whole virtual account number, partnerServiceId + customerNo </td></tr><tr><td>additionalInfo </td><td> </td><td> </td><td></td><td> </td></tr><tr><td>     billerCode </td><td>M</td><td>String</td><td>3</td><td>Code of the biller, can be filled with bank code  </td></tr><tr><td>     sourceAccountNo </td><td>M</td><td>String</td><td>20</td><td>Source account number </td></tr></tbody></table>

&#x20;

{% tabs %}
{% tab title="Request Sample Inquiry Bill Payment to VA from Intrabank" %}

```json
{
  "partnerReferenceNo": "1723105206783",
  "partnerServiceId": "     126",
  "customerNo": "085212344321",
  "virtualAccountNo": "126085212344321",
  "additionalInfo": {
    "billerCode": "014",
    "sourceAccountNo": "9920011089"
  }
}
```

{% endtab %}
{% endtabs %}

#### Response Parameter – Inquiry Bill Payment to VA Intrabank

The parameter that must be provide by the Partner system to be accessed by the Faspay system are as follows:

<table><thead><tr><th width="275">SNAP Parameter </th><th width="87">M/O/C</th><th width="105">Data Type</th><th width="84">Length</th><th>Description </th></tr></thead><tbody><tr><td>responseCode </td><td>M</td><td>String</td><td>7</td><td>Response code </td></tr><tr><td>responseMessage </td><td>M</td><td>String</td><td>150</td><td>Response description </td></tr><tr><td>virtualAccountData </td><td> </td><td></td><td></td><td> </td></tr><tr><td>     partnerReferenceNo </td><td>M</td><td>String</td><td>64</td><td>Transaction identifier on Partner’s system </td></tr><tr><td>     partnerServiceId </td><td>M</td><td>String</td><td>8</td><td>Company code, 8 digit left padding space </td></tr><tr><td>     customerNo </td><td>M</td><td>String</td><td>20</td><td>Unique customer number (up to 20 digits) </td></tr><tr><td>     virtualAccountNo  </td><td>M</td><td>String</td><td>28</td><td>Whole virtual account number, partnerServiceId + customerNo </td></tr><tr><td>     virtualAccountName </td><td>O</td><td>String</td><td>50</td><td>Virtual account name </td></tr><tr><td>     totalAmount </td><td>O</td><td>Object</td><td></td><td> </td></tr><tr><td>          value </td><td>M</td><td>String</td><td>16,2</td><td>Amount of the transaction based on ISO 4217</td></tr><tr><td>          currency </td><td>O</td><td>String</td><td>3</td><td>Currency of transaction based on ISO 4217 </td></tr><tr><td>     virtualAccountTrxType </td><td>O</td><td>String</td><td>1</td><td><p>Types of virtual account </p><p> </p><p>Type: </p><p>O = Open Payment </p><p>C = Closed Payment </p></td></tr><tr><td>additionalInfo </td><td>M</td><td>Object</td><td></td><td> </td></tr><tr><td>     billerCode </td><td>M</td><td>String</td><td>3</td><td>Code of the biller, can be filled with bank code  </td></tr><tr><td>     sourceAccountNo </td><td>M</td><td>String</td><td>20</td><td>Source account number </td></tr><tr><td>     status </td><td>M</td><td>String</td><td>1</td><td><p>List registration </p><p> </p><p>status:  </p><p>1 = On Process </p><p>6 = Already Registered </p></td></tr><tr><td>     message </td><td>M</td><td>String</td><td></td><td>Message description </td></tr></tbody></table>

&#x20;

{% tabs %}
{% tab title="Response Sample Inquiry Bill Payment to VA from Intrabank" %}

```json
{
  "responseCode": "2003200",
  "responseMessage": "Request has been processed successfully",
  "virtualAccountData": {
    "partnerServiceId": "     126",
    "customerNo": "085212344321",
    "virtualAccountNo": "126085212344321",
    "virtualAccountName": "fXXXXXXXXXXXXXs",
    "totalAmount": {
      "value": "11500.00",
      "currency": "IDR"
    },
    "virtualAccountTrxType": "C",
    "partnerReferenceNo": "1723105206783"
  },
  "additionalInfo": {
    "billerCode": "014",
    "sourceAccountNo": "9920011089",
    "status": "2",
    "message": "Success"
  }
}
```

{% endtab %}
{% endtabs %}

#### Bill Payment to VA from Intrabank

This API is used to Bill Payment transaction.

<table data-header-hidden><thead><tr><th width="170"></th><th></th></tr></thead><tbody><tr><td><strong>URL Path</strong></td><td>.../{version}/transfer-va/payment-intrabank</td></tr><tr><td><strong>Method</strong></td><td>POST</td></tr><tr><td><strong>Channel Code</strong></td><td>32</td></tr></tbody></table>

#### &#x20;Request Parameter – Bill Payment to VA from Intrabank

The parameter that must be provide by the partner system to be accessed by the Faspay system are as follows:

<table><thead><tr><th width="242">Parameter </th><th width="99">M/O/C</th><th>Data Type</th><th>Length</th><th>Description </th></tr></thead><tbody><tr><td>partnerReferenceNo </td><td>O</td><td>String</td><td>64</td><td>Unique identifier for this Payment. Generated by Partner </td></tr><tr><td>partnerServiceId </td><td>M</td><td>String</td><td>8</td><td>Company code, 8 digit left padding space </td></tr><tr><td>customerNo </td><td>M</td><td>String</td><td>20</td><td>Unique customer number (up to 20 digits) </td></tr><tr><td>virtualAccountNo </td><td>M</td><td>String</td><td>28</td><td>Whole virtual account number, partnerServiceId + customerNo </td></tr><tr><td>virtualAccountName</td><td>O</td><td>String</td><td>50</td><td>Virtual account name </td></tr><tr><td>sourceAccountNo</td><td>M</td><td>String</td><td>20</td><td>Source Account Number </td></tr><tr><td>paidAmount</td><td>M</td><td>Object</td><td> </td><td> </td></tr><tr><td>value</td><td>M</td><td>String</td><td>16,2</td><td><p>Paid amount for this transaction</p><p><br></p><p><strong>Notes:</strong> </p><ul><li>If it’s IDR then value includes 2 decimal digits. e.g. IDR 10.000,- will be placed with 10000.00</li><li>Amount <strong>isn't allowed decimal</strong> <strong>other than 00</strong></li></ul></td></tr><tr><td>currency</td><td>M</td><td>String</td><td>3</td><td>Currency of transaction based on ISO 4217 </td></tr><tr><td>trxDateTime</td><td>M</td><td>DateTime</td><td>25</td><td>Partner’s internal system datetime with timezone, which follows the ISO-8601 standard </td></tr><tr><td>additionalInfo </td><td>M</td><td>Object</td><td></td><td> </td></tr><tr><td>     billerCode </td><td>M</td><td>String</td><td>3</td><td>Code of the biller, can be filled with bank code  </td></tr><tr><td>instructDate</td><td> </td><td> </td><td> </td><td><p>Instruct date is date for transaction ISO-8601</p><p>FORMAT: ‘yyyyMMdd’T’HH:mm:ss TZD’</p><p> </p><p>Notes: Only fill out when the desired transaction wants to be scheduled. If it’s null, then the transaction will be done in real-time.</p></td></tr><tr><td>callbackURL</td><td>M</td><td>String</td><td>255</td><td>URL for callback / notification, it will be used for notifying partner.</td></tr></tbody></table>

&#x20;

{% tabs %}
{% tab title="Request Sample Bill Payment to VA from Intrabank" %}

```json
{
  "partnerReferenceNo": "1723105403186",
  "partnerServiceId": "     126",
  "customerNo": "085212344321",
  "virtualAccountNo": "126085212344321",
  "virtualAccountName": "fXXXXXXXXXXXXXs",
  "sourceAccountNo": "9920011089",
  "paidAmount": {
    "value": "11500.00",
    "currency": "IDR"
  },
  "trxDateTime": "2024-08-08T15:23:23",
  "additionalInfo": {
    "billerCode": "014",
    "instructDate": "",
    "callbackUrl": "http://account-service/account/api/mail/sendtotele"
  }
}
```

{% endtab %}
{% endtabs %}

#### Response Parameter – Bill Payment to VA from Intrabank

&#x20;The parameter that must be provide by the partner system to be accessed by the Faspay system are as follows:

<table><thead><tr><th width="271">Parameter </th><th>M/O/C</th><th>Data Type</th><th width="100">Length</th><th>Description </th></tr></thead><tbody><tr><td>responseCode </td><td>M</td><td>String</td><td>7</td><td>Response code </td></tr><tr><td>responseMessage </td><td>M</td><td>String</td><td>150</td><td>Response description </td></tr><tr><td>virtualAccountData </td><td>M</td><td>Object</td><td></td><td> </td></tr><tr><td>     partnerReferenceNo </td><td>M</td><td>String</td><td>64</td><td>Transaction identifier on partner’s system </td></tr><tr><td>     referenceNo </td><td>M</td><td>String</td><td>64</td><td>Transaction identifier on Faspay’s system. Must be filled upon successful transaction </td></tr><tr><td>     partnerServiceId </td><td>M</td><td>String</td><td>8</td><td>Company code, 8 digit left padding space </td></tr><tr><td>     customerNo </td><td>M</td><td>String</td><td>20</td><td>Unique customer number (up to 20 digits) </td></tr><tr><td>     virtualAccountNo  </td><td>M</td><td>String</td><td>28</td><td>Whole virtual account number, partnerServiceId + customerNo </td></tr><tr><td>     virtualAccountName </td><td>O</td><td>String</td><td>50</td><td>Virtual account name </td></tr><tr><td>     sourceAccountNo </td><td>M</td><td>String</td><td>20</td><td>Source Account Number </td></tr><tr><td>     paidAmount </td><td>M</td><td>Object</td><td></td><td> </td></tr><tr><td>          value </td><td>M</td><td>String</td><td>16,2</td><td><p>Paid amount for this transaction (ISO 4217)</p><p> </p></td></tr><tr><td>          currency </td><td>M</td><td>String</td><td>3</td><td>Currency of transaction based on ISO 4217 </td></tr><tr><td>     trxDateTime </td><td>M</td><td>DateTime</td><td>25</td><td>Partner’s internal system datetime with timezone, which follows the ISO-8601 standard </td></tr><tr><td>additionalInfo </td><td>M</td><td>Object</td><td></td><td> </td></tr><tr><td>     billerCode </td><td>M</td><td>String</td><td>3</td><td>Code of the biller, can be filled with bank code  </td></tr><tr><td>     instructDate </td><td>M</td><td>DateTime</td><td>50</td><td><p>Instruct date is date for transaction ISO-8601 </p><p> </p><p>FORMAT: ‘yyyyMMdd’T’HH:mm:ss TZD’ </p><p> </p><p>Only fill out when the desired transaction wants to be scheduled. If it’s null, then the transaction will be done in real-time. </p></td></tr><tr><td>     callbackUrl </td><td>M</td><td>String</td><td>255</td><td>URL for callback / notification, it will be used for notifying partner. </td></tr><tr><td>     status </td><td>M</td><td>String</td><td>-</td><td><p>List of status transaction:  </p><p> </p><p>1 = On Process,  </p><p>2 = Success,  </p><p>4 = Failed,  </p><p>5 = Reverse </p></td></tr><tr><td>     message </td><td>M</td><td>String</td><td>-</td><td>Message transaction </td></tr></tbody></table>

&#x20;

{% tabs %}
{% tab title="Response Sample Bill Payment to VA from Intrabank" %}

```json
{
  "responseCode": "2003300",
  "responseMessage": "Request has been processed successfully",
  "virtualAccountData": {
    "partnerReferenceNo": "1723105403186",
    "referenceNo": "4147193",
    "partnerServiceId": "     126",
    "customerNo": "085212344321",
    "virtualAccountNo": "126085212344321",
    "virtualAccountName": "fXXXXXXXXXXXXXs",
    "sourceAccountNo": "9920011089",
    "paidAmount": {
      "value": "11500.00",
      "currency": "IDR"
    },
    "trxDateTime": "2024-08-08T15:23:23"
  },
  "additionalInfo": {
    "billerCode": "014",
    "instructDate": "",
    "callbackUrl": "
http://account-service/account/api/mail/sendtotele"
,
    "status": "1",
    "message": "On Process"
  }
}
```

{% 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/snap/snap-disbursement.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.