# 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="https://3692871117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHl0oXefaAKjpRLPnGw%2Fuploads%2FsFUEMPqmzJmv47amKR5e%2Fimage.png?alt=media&#x26;token=e6d2c503-f39a-440d-8525-50f114f26040" 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="https://3692871117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHl0oXefaAKjpRLPnGw%2Fuploads%2FA8jSTiwYp27wrySlKVoi%2Fimage.png?alt=media&#x26;token=30763103-d34b-46fa-b5fb-2eb3a3f860a3" 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 %}