Taiwan Payment API
About 1017 wordsAbout 3 min
Warning
Before reading this API document, please make sure to check API Description Guide
Limits
| Transaction Type | Limit |
|---|---|
| Collection | USD: 0.99-499.99, TWD: 100-20000 |
Collection API
Collection Application
Brief Description:
- Create a collection order
URL:
TWD: /twd/collect/apply Note: appId TWD, amount TWD, settlement TWD
USD: /usd/collect/apply Note: appId USD, amount USD, settlement USD
Parameters:
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| appId | Yes | Long | Business ID (obtained from the backend, needs to pass the corresponding business ID according to the currency in the URL) |
| orderId | Yes | String | Merchant order number (must be unique, max length 48) |
| name | Yes | String | User’s full name. Recommended to use real name. Format: firstName and lastName separated by a space. Example: Donald John Trump |
| phone | Yes | String | Real phone number |
| Yes | String | Real email | |
| amount | Yes | String | Transaction amount. For TWD orders, decimals are not allowed |
| payType | Yes | String | Transaction type |
| inBankCode | Yes | String | Payment method |
| callBackUrl | Yes | String | Redirect URL after successful payment |
| callBackFailUrl | Yes | String | Redirect URL after failed payment |
| notifyUrl | No | String | Callback URL |
| subject | Yes | String | Payment note |
| body | No | String | Additional details |
| country | No | String | Required for cashier mode, fixed value: 158 |
| currency | No | String | Currency (default TWD; supported currencies: USD, TWD) |
| partnerUserId | Yes | String | Unique user identifier (e.g., userId). Used for risk control. Must be valid, otherwise it will affect the transaction. Allowed format: numbers, uppercase/lowercase letters, or common symbols -~!@#$%&*()_. |
| sign | Yes | String | Signature |
Return data parameter description
| Parameter Name | Type | Description |
|---|---|---|
| orderId | String | Merchant order number (must be unique) |
| orderNo | String | Platform order number |
| payUrl | String | Payment link |
| sign | String | Signature |
Collection Query
Brief Description:
- Query collection order
URL:
TWD: /twd/collect/query
USD: /usd/collect/query
Parameters:
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| appId | Yes | Long | Business ID (obtained from the backend, needs to pass the corresponding business ID according to the currency in the URL) |
| orderId | Yes | String | Merchant order number |
| orderNo | No | String | Platform order number (faster response) |
| sign | Yes | String | Signature |
Return data parameter description
| Parameter Name | Type | Description |
|---|---|---|
| orderId | String | Merchant order number (must be unique) |
| orderNo | String | Platform order number |
| amount | String | Transaction amount |
| actualAmount | String | Amount received |
| fee | String | Transaction fee |
| status | Integer | Status (0: Not started, 1: Processing, 2: Success (final), 3: Failed (final), 4: Partial received (final), 5: Over-received (final), -1: Exception pending confirmation) |
| payTime | String | Payment success time (available when status=2,4,5). Local time format: yyyy-MM-dd HH:mm:ss |
| errorMsg | String | Payment failure reason (available when status=3) |
| sign | String | Signature |
Payment Methods
| Currency | Payment Type (payType) | Payment Code (inBankCode) | Limit | Status | Description |
| TWD | QR | JKO_PAY_QR | 30-20000 | Available | JkoPay QR |
| TWD | EWALLET | JKO_PAY_TWD | 30-20000 | Available | JKO Pay |
| TWD | BANK_TRANSFER | ATM | 1000-20000 | Available | ATM Cashier |
| TWD | BANK_TRANSFER | STORE_IBON | 100-20000 | Available | 7-11 Convenience Store |
| TWD | BANK_TRANSFER | STORE_HILIFEET | 100-20000 | Available | Hi-Life Life-ET |
| TWD | BANK_TRANSFER | STORE_OKGO | 100-20000 | Available | OK Mart OK-go |
| TWD | BANK_TRANSFER | STORE_FAMI | 100-20000 | Available | FamilyMart FamiPort |
| TWD | BANK_TRANSFER | STORE_MBC_HILIFEET | 100-20000 | Available | Convenience store mobile QR scan (Hi-Life Life-ET) |
| TWD | BANK_TRANSFER | STORE_MBC_IBON | 100-20000 | Available | 7-11 Convenience store mobile QR scan |
| USD | EWALLET | JKO_PAY | 0.99-499.99 | Available | JKO Pay |
| USD | BANK_TRANSFER | LINE_PAY_USD | 2.99-499.99 | Available | Line Pay |
| USD | BANK_TRANSFER | ATM_USD | 32.99-499.99 | Available | ATM Cashier |
| USD | BANK_TRANSFER | STORE_IBON_USD | 2.99-499.99 | Available | 7-11 Convenience Store |
| USD | BANK_TRANSFER | STORE_HILIFEET_USD | 2.99-499.99 | Available | Hi-Life Life-ET |
| USD | BANK_TRANSFER | STORE_OKGO_USD | 2.99-499.99 | Available | OK Mart OK-go |
| USD | BANK_TRANSFER | STORE_FAMI_USD | 2.99-499.99 | Available | FamilyMart FamiPort |
| USD | BANK_TRANSFER | STORE_MBC_HILIFEET_USD | 2.99-499.99 | Available | Convenience store mobile QR scan (Hi-Life Life-ET) |
| USD | BANK_TRANSFER | STORE_MBC_IBON_USD | 2.99-499.99 | Available | Convenience store mobile QR scan (7-Eleven) |