# SNAP Create Virtual Account

This API is used to create virtual account in SNAP standard for route payment.

<table data-header-hidden><thead><tr><th width="165"></th><th></th></tr></thead><tbody><tr><td><strong>URL Path</strong></td><td><a href="https://debit-sandbox.faspay.co.id/v1.0/transfer-va/create-va">https://debit-sandbox.faspay.co.id/v1.0/transfer-va/create-va</a></td></tr><tr><td><strong>Method</strong></td><td>POST</td></tr></tbody></table>

## Request Parameter

The parameters that must be provided by the Merchant system to be accessed by the Faspay system are as follows:

<table><thead><tr><th width="271">SNAP Parameter</th><th width="149">Data Type</th><th width="85">M/O/C</th><th>Description</th></tr></thead><tbody><tr><td>virtualAccountName</td><td>String (128)</td><td>M</td><td>Customer name</td></tr><tr><td>virtualAccountEmail</td><td>String (128)</td><td>O</td><td>Customer email</td></tr><tr><td>virtualAccountPhone</td><td>String (30)</td><td>O</td><td>Customer's phone number. Format: 62xxxxxxxxxxxxx</td></tr><tr><td>trxId</td><td>String (32)</td><td>M</td><td>Transaction ID in Partner system</td></tr><tr><td>totalAmount</td><td>Object</td><td>O</td><td> </td></tr><tr><td>    value</td><td>String (16,2)</td><td>M</td><td>Transaction Amount. Total Amount with 2 decimals</td></tr><tr><td>    currency</td><td>String (3)</td><td>M</td><td>Currency = IDR</td></tr><tr><td>expiredDate</td><td>String (25)</td><td>O</td><td>Expiration date for Virtual Account. ISO-8601</td></tr><tr><td>additionalInfo</td><td>Object</td><td>O</td><td>Additional Information</td></tr><tr><td>    billDate</td><td>Datetime (25)</td><td>M</td><td>Transaction/ Order Date.<br>local time in yyyy-MM-ddTHH:mm:ssTZD format</td></tr><tr><td>    channelCode</td><td>Numeric (32)</td><td>M</td><td>Payment Channel Code VA ONLY refer to <a href="https://docs.faspay.co.id/merchant-integration/api-reference-1/debit-transaction/reference/payment-channel-code">here</a>.</td></tr><tr><td>    billDescription</td><td>String (18)</td><td>M</td><td>Bill description</td></tr><tr><td>    route</td><td>Object</td><td>O</td><td> </td></tr><tr><td>       owner</td><td>Alphanumeric (32) </td><td>O</td><td><p>Registered partner id that owns/generates the transaction. </p><p> </p><p><strong>Notes:</strong></p><ul><li>1 transaction only can contain 1 owner. </li><li> If null, then the remaining transaction amount will belong to the merchant’s Sendme balance. </li></ul></td></tr><tr><td>       partnerId</td><td>Alphanumeric (32) </td><td>O</td><td>Merchant partner id number.</td></tr><tr><td>      partnerAmount</td><td>Numeric (15) </td><td>C</td><td>Disbursement amount to partner.  </td></tr></tbody></table>

### Sample Request

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

```json
{
    "virtualAccountName": "Andi",
    "virtualAccountEmail": "andi@gmail.com",
    "virtualAccountPhone": "12345",
    "trxId": "7970999936312263",
    "totalAmount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "expiredDate": "2024-09-19T16:20:00+07:00",
    "additionalInfo": {
        "billDate": "2024-09-18T09:00:00+07:00",
        "channelCode": "708",
        "billDescription": "transaction",
        "route": [
            {
                "owner": "26100253"
            },
            {
                "partnerId": "29195827",
                "partnerAmount": "5000.00"
            },
            {
                "partnerId": "andre-121321346",
                "partnerAmount": "5000.00"
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

## Response Parameter

Response parameters are parameters that will be delivered by Faspay system in response to the request that have been sent by the merchant system. If no parameters appropriate/value are incorrect, the transaction will be rejected in the system Faspay.

<table><thead><tr><th width="320">SNAP Parameter</th><th width="179">Data Type</th><th width="78">M/O/C</th><th>Description</th></tr></thead><tbody><tr><td>responseCode</td><td>String (7)</td><td>M</td><td>Response code. In details <a href="/pages/rtKHzHoYL4gBW3Z4iWQr">here</a>.</td></tr><tr><td>responseMessage</td><td>String (150)</td><td>M</td><td>Response description. In details <a href="/pages/rtKHzHoYL4gBW3Z4iWQr">here</a>.</td></tr><tr><td>virtualAccountData</td><td>Object</td><td>M</td><td> </td></tr><tr><td>    partnerServiceId</td><td>String (8)</td><td>M</td><td>Derivative of X-PARTNER-ID , similar to company code, 8 digit left padding space</td></tr><tr><td>    customerNo</td><td>String (20)</td><td>M</td><td>Unique number (up to 20 digits)</td></tr><tr><td>    virtualAccountNo</td><td>String (28)</td><td>M</td><td>partnerServiceId (8 digit left padding space) + customerNo (up to 20 digits)</td></tr><tr><td>    virtualAccountName</td><td>String (128)</td><td>M</td><td>Customer name</td></tr><tr><td>    virtualAccountEmail</td><td>String (128)</td><td>O</td><td>Customer email</td></tr><tr><td>    virtualAccountPhone</td><td>String (30)</td><td>O</td><td>Customer's phone number. Format: 62xxxxxxxxxxxxx</td></tr><tr><td>    trxId</td><td>String (32)</td><td>M</td><td>From create VA request</td></tr><tr><td>    totalAmount</td><td>Object</td><td>O</td><td> </td></tr><tr><td>        value</td><td>String (ISO4217) (16,2)</td><td>M</td><td>Transaction amount. The total amount with 2 decimals.</td></tr><tr><td>       currency</td><td>String (3)</td><td>M</td><td>Currency. Currency of amount based on ISO 4217.</td></tr><tr><td>    expiredDate</td><td>String (25)</td><td>M</td><td>Expiration date for Virtual Account. ISO-8601</td></tr><tr><td>    additionalInfo</td><td>Object</td><td>O</td><td>Additional Information for custom use</td></tr><tr><td>        billDate</td><td>Datetime (25)</td><td>M</td><td>Transaction/ order date</td></tr><tr><td>        channelCode</td><td>Numeric (32)</td><td>M</td><td>Payment channel code VA ONLY</td></tr><tr><td>         billDescription</td><td>String (18)</td><td>M</td><td>Bill description</td></tr><tr><td>         route</td><td>Object</td><td>O</td><td> </td></tr><tr><td>             owner</td><td>Alphanumeric (32) </td><td>O</td><td><p>Registered partner id that owns/generates the transaction. </p><p> </p><p><strong>Notes:</strong></p><ul><li>1 transaction only can contain 1 owner. </li><li>If null, then the remaining transaction amount will belong to the merchant’s Sendme balance. </li></ul></td></tr><tr><td>           partnerid</td><td>Alphanumeric (32) </td><td>O</td><td>Merchant partner id number.</td></tr><tr><td>          partneramount</td><td>Numeric (15) </td><td>C</td><td>Disbursement amount to partner.  </td></tr><tr><td>        redirectUrl</td><td>String</td><td>O</td><td>Merchant call back URL</td></tr></tbody></table>

### Sample Response

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

```json
{
    "responseCode": "2002700",
    "responseMessage": "Success",
    "virtualAccountData": {
        "partnerServiceId": "  338309",
        "customerNo": "25000598",
        "virtualAccountNo": "1726631925000598",
        "virtualAccountName": "Andi",
        "virtualAccountEmail": "andi@gmail.com",
        "virtualAccountPhone": "12345",
        "trxId": "7970999936312263",
        "totalAmount": {
            "value": "10000.00",
            "currency": "IDR"
        },
        "expiredDate": "2024-09-19T16:20:00+07:00",
        "additionalInfo": {
            "billDate": "2024-09-18T09:00:00+07:00",
            "channelCode": "708",
            "billDescription": "transaction",
            "route": [
                {
                    "owner": "26100253"
                },
                {
                    "partnerId": "29195827",
                    "partnerAmount": "5000.00"
                },
                {
                    "partnerId": "andre-121321346",
                    "partnerAmount": "5000.00"
                }
            ],
            "redirectUrl": "https://debit-sandbox.faspay.co.id/pws/100003/0830000010100000/d3cf14a84807d0d8240813243b26ee26de6e9739?trx_id=1726631925000598&merchant_id=99999&bill_no=7970999936312263"
        }
    }
}
```

{% 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/route-payment/snap-create-virtual-account.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.