> For the complete documentation index, see [llms.txt](https://docs.galaxypay.vn/upc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.galaxypay.vn/upc/payment-gateway/api-specification/payment/fast-pay.md).

# Fast pay

*<mark style="color:orange;">Only apply for International card.</mark>*

APIOperation = <mark style="color:red;">FAST\_PAY</mark>

See information of Fast Pay [here](/upc/payment-gateway/payment-solution/fast-pay.md)

## Integration

See integration detail in [General integration steps](/upc/payment-gateway/payment-solution/general-integration-steps.md)

{% hint style="info" %}
Refer to the [Code Samples and API Playground](https://uat-demo.galaxypay.vn/documents#post-/api/v1/transaction/pay) for detailed sample code and API testing.
{% endhint %}

| Endpoint URL | Route                  |
| ------------ | ---------------------- |
| Base URL     | api/v1/transaction/pay |

Example:

<https://uat-secure.galaxypay.vn/api/v1/transaction/pay>

### Request Message

#### Header

<table><thead><tr><th width="87">Level</th><th width="189">Field Name</th><th width="186">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>apiKey</td><td>Alphanumeric<br><em><mark style="color:blue;">mandatory</mark></em></td><td>Request authenticate</td></tr><tr><td>1</td><td>signature</td><td>Alphanumeric<br><em><mark style="color:blue;">mandatory</mark></em></td><td>Request signature</td></tr></tbody></table>

#### Body

<table><thead><tr><th width="87">Level</th><th width="199">Field Name</th><th width="178">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>requestID<br></td><td>Alphanumeric(50)<br><em><mark style="color:blue;">mandatory</mark></em></td><td><p>Unique ID for each transaction request</p><p></p><p><strong>Recommend</strong>: GUID</p></td></tr><tr><td>1</td><td>requestDateTime</td><td>Numeric(14)<br><em><mark style="color:blue;">mandatory</mark></em></td><td><strong>yyyyMMddHHmmss</strong></td></tr><tr><td>1</td><td>requestData</td><td>JSON Object</td><td></td></tr><tr><td>2</td><td>apiVersion</td><td>Numeric(5)<br><em><mark style="color:blue;">optional</mark></em></td><td>Specify the api version. Current supported version is 2.<br><br>If this field is omitted, the default value of apiVersion is <strong>1</strong></td></tr><tr><td>2</td><td>apiOperation</td><td>Alpha(20)<br><em><mark style="color:blue;">mandatory</mark></em></td><td><strong>FAST_PAY</strong></td></tr><tr><td>2</td><td>orderID</td><td>Alphanumeric(50)<br><em><mark style="color:blue;">mandatory</mark></em></td><td>Transaction ID at Merchant</td></tr><tr><td>2</td><td>orderNumber</td><td>Alphanumeric(20)<br><em><mark style="color:blue;">optional</mark></em></td><td>Order Number or Bill Number</td></tr><tr><td>2</td><td>orderAmount</td><td>Numeric(16)<br><em><mark style="color:blue;">mandatory</mark></em></td><td>Transaction Amount</td></tr><tr><td>2</td><td>orderCurrency</td><td>Alpha(3)<br><em><mark style="color:blue;">mandatory</mark></em></td><td>Send the code in <a href="/pages/9qc6oGrvkG54qieoVRAW">Currencies</a></td></tr><tr><td>2</td><td>orderDateTime</td><td>Numeric(14)<br><em><mark style="color:blue;">mandatory</mark></em></td><td><strong>yyyyMMddHHmmss</strong></td></tr><tr><td>2</td><td>orderDescription</td><td>Alphanumeric(250)<br><em><mark style="color:blue;">mandatory</mark></em></td><td>Transaction Description</td></tr><tr><td>2</td><td>paymentMethod</td><td>Alpha(20)<br><em><mark style="color:blue;">mandatory</mark></em></td><td><strong>INTERNATIONAL:</strong> International Card</td></tr><tr><td>2</td><td>language</td><td>Alpha(2)<br><em><mark style="color:blue;">optional</mark></em></td><td><p>vi or en</p><p></p><p>vi: Vietnamese</p><p>en: English</p></td></tr><tr><td>2</td><td>isAutoCapture</td><td>Alpha(20)<br><em><mark style="color:blue;">optional</mark></em></td><td><p>true or false</p><p></p><p>default: true</p><p>Only apply for <strong>International Card</strong></p><p></p><p><strong>Required</strong> call API <a href="/pages/YODgMw0HIEsYNhZ3kRor">Capture</a> in case <strong>false</strong> to finish transaction</p><p>See <a href="https://docs.galaxypay.vn/upc/payment-gateway/appendix/glossary#isautocapture">isAutoCapture</a> for more detail</p></td></tr><tr><td>2</td><td>successURL</td><td>Alphanumeric(500)<br><em><mark style="color:blue;">optional</mark></em></td><td>Callback URL when Payment is success</td></tr><tr><td>2</td><td>failureURL</td><td>Alphanumeric(500)<br><em><mark style="color:blue;">optional</mark></em></td><td>Callback URL when Payment is failure</td></tr><tr><td>2</td><td>cancelURL</td><td>Alphanumeric(500)<br><em><mark style="color:blue;">optional</mark></em></td><td>Callback URL when Customer cancel payment</td></tr><tr><td>2</td><td>ipnURL</td><td>Alphanumeric(500)<br><em><mark style="color:blue;">optional</mark></em></td><td>IPN URL</td></tr><tr><td>2</td><td>subMerchant</td><td>JSON Object<br><em><mark style="color:blue;">optional</mark></em></td><td>Only use for master merchant scope</td></tr><tr><td>3</td><td>identifier</td><td>String(50)<br><em><mark style="color:blue;">optional</mark></em></td><td>Sub-merchant ID</td></tr><tr><td>2</td><td>sourceOfFund</td><td>Alpha(50)<br><em><mark style="color:blue;">optional</mark></em></td><td><strong>CARD</strong> or <strong>TOKEN</strong><br><br><strong>Required</strong> <strong>when</strong> paymentMethod = <strong>DOMESTIC</strong> or <strong>INTERNATIONAL</strong> </td></tr><tr><td>2</td><td>cardNumber</td><td>Numeric(19)<br><em><mark style="color:blue;">condition</mark></em></td><td><p><strong>Required</strong> <strong>when</strong> </p><p>sourceOfFund = <strong>CARD</strong></p></td></tr><tr><td>2</td><td>cardHolderName</td><td>Alphanumeric(19)<br><em><mark style="color:blue;">condition</mark></em></td><td><p><strong>Required</strong> <strong>when</strong> </p><p>sourceOfFund = <strong>CARD</strong></p></td></tr><tr><td>2</td><td>cardExpireDate</td><td>Alphanumeric(5)<br><em><mark style="color:blue;">condition</mark></em></td><td><p><strong>Required</strong> <strong>when</strong> </p><p>sourceOfFund = <strong>CARD</strong></p><p>Format: MM/YY</p></td></tr><tr><td>2</td><td>cardVerificationValue</td><td>Numeric(3)<br><em><mark style="color:blue;">condition</mark></em></td><td><p><strong>Required</strong> <strong>when</strong> </p><p>sourceOfFund = <strong>CARD</strong><br><br><strong>Only use for International Card</strong></p></td></tr><tr><td>2</td><td>token</td><td>Alphanumeric(50)<br><em><mark style="color:blue;">condition</mark></em></td><td><p><strong>Required</strong> <strong>when</strong> </p><p>sourceOfFund = <strong>TOKEN</strong></p></td></tr><tr><td>2</td><td>extraData</td><td>JSON Object<br><em><mark style="color:blue;">optional</mark></em></td><td><p>Extra data. </p><p>Same as <a href="/pages/RAa5rTe6VE7oVV3DDnKh#body">API Pay</a></p></td></tr></tbody></table>

#### Sample request

```
{
  "apiVersion": "1",
  "language": "vi",
  "billNumber": "74118",
  "orderAmount": "10,000",
  "orderCurrency": "VND",
  "orderDescription": "Secure Page Demo",
  "paymentMethod": "INTERNATIONAL",
  "sourceType": "",
  "extraData": {
  },
  "cardNumber": "5123450000000008",
  "cardHolderName": "Nguyen Van A",
  "cardExpireDate": "12/39",
  "cardVerificationValue": "111",
  "integrationMethod": "HOSTED",
  "apiOperation": "FAST_PAY",
  "merchantID": "9339",
  "successURL": "https://uat-demo.galaxypay.vn/api/result",
  "cancelURL": "https://uat-demo.galaxypay.vn/api/cancel",
  "ipnURL": "https://uat-demo.galaxypay.vn/api/ipn",
  "baseUrl": "https://uat-demo.galaxypay.vn/",
  "sourceOfFund": "CARD",
  "isAutoCapture": true,
  "isUseOtp": false
}
```

### Response message

#### Header

<table><thead><tr><th width="101">Level</th><th width="182">Field name</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>signature</td><td>Alphanumeric<br><em><mark style="color:blue;">mandatory</mark></em></td><td>Response signature</td></tr></tbody></table>

#### Body

<table><thead><tr><th width="99">Level</th><th width="184">Field name</th><th width="188">Data type</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>requestID</td><td>Alphanumeric(50)<br><em><mark style="color:blue;">mandatory</mark></em></td><td>Original Request ID</td></tr><tr><td>1</td><td>responseDateTime</td><td>Numeric(14)<br><em><mark style="color:blue;">mandatory</mark></em></td><td><strong>yyyyMMddHHmmss</strong></td></tr><tr><td>1</td><td>responseCode</td><td>Numeric(3)<br><em><mark style="color:blue;">mandatory</mark></em></td><td>See <a href="/pages/sBk2eUqKYscTG2fiXwOK">Response Codes</a> for more detail</td></tr><tr><td>1</td><td>responseMessage</td><td>Alphanumeric(250)<br><em><mark style="color:blue;">mandatory</mark></em></td><td>Response message</td></tr><tr><td>1</td><td>responseData</td><td>JSON Object<br><em><mark style="color:blue;">mandatory</mark></em></td><td>Response data</td></tr><tr><td>2</td><td>transactionID</td><td>Alphanumeric(38)<br><em><mark style="color:blue;">mandatory</mark></em></td><td>GALAXY PAY transaction ID</td></tr></tbody></table>

#### Sample response

```
{
    "requestID": "d1f49f187e0344d3a9b020af15b6dc78",
    "responseDateTime": "20241111152140",
    "responseData": {
        "transactionID": "2411115365746677264803951"
        },
    "responseCode": "200",
    "responseMessage": "Success"
}
```