SDK Parameter Reference
Field | Type | M/O | Description |
|---|---|---|---|
type | String | M | Fixed value: |
sessionID | String | M | The sessionID returned by the interaction (LinkPay) API (16-character UUID in current LinkPay URL) |
locale | String | O | Language for Drop-in display. Example: |
environment | String | M | Set the environment for requests, e.g., |
mode | String | M |
|
uiOption | Object | O | |
| Object | O | Customize card payment section setting |
| boolean | O | To indicate if user is required to input card holder name when choosing card payment |
| boolean | O | To indicate if user is required to input CVV when choosing saved card to proceed payment |
| Object | O | Customize TnC section setting |
| boolean | O | To indicate if TnC is displayed. |
| boolean | O | Value for how user accepting TnC. |
| String | O | Mandatory field when |
appearance | Object | O | Customize Drop-in appearance |
| String | O | Checkbox or clickable button color, hex code (e.g., |
| String | O | Drop-in background color, hex code |
| String | O | Border/line color, hex code |
| String | O | Disabled button color, hex code |
| String | O | Error border and text color, hex code |
| String | O | Input background color, hex code |
| String | O | Input border color, hex code |
| String | O | Button text color, hex code |
| String | O | Input border when selected, hex code |
| String | O | Input placeholder color, hex code |
| String | O | Primary font color, hex code |
| String | O | Secondary font color, hex code |
| Object | O | Button font style |
| Object | O | Heading font style |
| Object | O | Subheading font style |
| Object | O | Popup heading font style |
| Object | O | Label font style |
| Object | O | Label info font style |
| Object | O | Popup label font style |
| Object | O | Input field font style |
| Object | O | Input field info font style |
| Object | O | Input field popup font style |
| Object | O | Paragraph font style |
| Object | O | Input placeholder font style |
| Array | O | Page corner radius |
| String | O | Merchant logo position: |
payment_method_select
payment_method_selectReturned when merchant request isVerifyPaymentBrand: true in SDK and user enter card information in drop-in page
Merchants can use this event to receive the card information and control in SDK response to allow if the card able to proceed the payment
| Field | Type | M/O | Description |
|---|---|---|---|
| type | String | M | Fixed value: payment_method_selected |
| verificationID | String | M | 16-character UUID identifying the verification request |
| first6No | String | O | The first 6 digits of the card number |
| last4No | String | O | The last 4 digits of the card number |
| paymentBrand | String | O | The card brand (e.g., Visa, Mastercard, JCB) |
Merchant response: dropInInstance.value.callbackVerification({msg: '',isVaild: '', id})
| Field | Type | M/O | Description |
|---|---|---|---|
| msg | String | M | Custom message displayed to the user when isValid is false |
| isVaild | String | M | true or false |
| id | String | O | 16-character UUID identifying the verification request |
payment_completed
payment_completedReturned when the payment is successfully completed.
Merchants can use this event to update UI or notify users of a successful transaction.
| Field | Type | M/O | Description |
|---|---|---|---|
| type | String | M | Fixed value: payment_completed |
| sessionID | String | M | Same as sessionID in the payment command |
| merchantTransID | String | M | Merchant transaction ID, used for querying order details |
| econtext | Object | O | Returned when independent payment method info needs to be displayed |
payment_failed
payment_failedReturned when the payment fails.
Merchants should display
codeormessageto the user for further action.
| Field | Type | M/O | Description |
|---|---|---|---|
| type | String | M | Fixed value: payment_failed |
| sessionID | String | M | Same as sessionID in the payment command |
| merchantTransID | String | O | Merchant transaction ID |
| code | String | O | Response code returned for failed payment |
| message | String | O | Response message returned for failed payment |
payment_not_preformed
payment_not_preformedDrop-in uses this event for errors that occur before calling the payment API. Example: sessionID in the payment command does not exist or is invalid.
Also returned if Drop-in finds no available payment methods for the current order.
| Field | Type | M/O | Description |
|---|---|---|---|
| type | String | M | Fixed value: payment_not_preformed |
| sessionID | String | M | Same as sessionID in the payment command |
| code | String | O | Standard V/B class response code |
| message | String | O | Standard V/B class response message |
Standard Response Codes
| Code | Message |
|---|---|
| V0000 | field invalid format |
| V0001 | field absent or empty |
| V0002 | field invalid value |
| B2001 | Session ID not found |
| B2002 | Order has been paid |
| B2003 | Order closed |
| B2004 | Payment error |
| B2005 | No available payment method |
| B2006 | Payment failed (fallback code) |
payment_cancelled
payment_cancelledReturned when the user actively terminates the payment process in Drop-in.
Merchants should not treat this as a failed transaction. The transaction result must be verified via backend query.
| Field | Type | M/O | Description |
|---|---|---|---|
| type | String | M | Fixed value: payment_cancelled |
| sessionID | String | M | Same as sessionID in the payment command |
Updated 14 days ago
