Voucher Code

Introduction of Voucher Code

We provide voucher code functionality to support merchants' promotional activities:

  • Customers can configure voucher code activities according to rules in page access mode.
  • A voucher code cannot be used for both physical and virtual cards.
  • Voucher code cannot be reused once used.
  • Merchants provide voucher code for users. User enter the voucher code on payment page.
  • Each coupon code can only be used once.
  • The usage record can be queried in the merchant dashboard.
  • Support Card Application and Card Recharge two scenarios.

Merchant Configuration of Voucher Code

These information is required for both Card Application and Card Recharge Voucher Code.

ConfigurationMandatoryRemarks
Merchant IDYesID number of the merchant
Activity NumberYesUID of the activity
Enable/DisableYesOn/Off
Activation CategoriesYesVirtual Card; Physical Card
Voucher code Usage ConditionsYesCard Application: Full Application Fee
Card Recharge: Custom amount
TokenNoToken triggers the preferential fee. Multiple token can be configured. Example: DOG; ORDI
This parameter only supports users using a fixed token to trigger discounts.
Voucher Code AmountYesFixed fiat currency amount
Voucher Code DescriptionNoFront-end display requirements
Activity TimeNoStart time; End time
Voucher codeYesEach code is unique and usable once; follows current activity rules after configuration

Usage of Create Card Voucher Code

  • The voucher code is configured to be enabled.
  • Merchant is in the promotion period, the Voucher Code input box will be displayed on the card application page.
  • If the verification is successful, the fee reduction will be made according to the configuration rules.
  • If the verification fails, an error message will be displayed: The entered Voucher code is incorrect. Please input it again.

Order Webhook of Voucher Code

  • The webhook push contains parameter voucherCode.
  • The paymentAmount is the actual payment amount after deducting the discount of voucher code, and order amounts remain normal order amount.
  • When the payment amount is 0 after the voucherCode amount is reduced, the step of token transfer is skipped, but the order information is generated and the webhook is pushed.
ParameterDescription
EventTypeWebhookType
EventIdWebhook event ID
webhookSubscribeIdWebhook subscribe ID
dataReturned data
userIdUser email
CreateOrderIdCard creation order number
CardType1. Virtual card
2. Physical card
TransactionType1. Create card
2. Deposit
VoucherCodeVoucher code
Example: Ucard_13249scdjckbksfhiuew
PaymentAmountAmount of digital currency order
(Corresponding recharge token)
PaymentCurrencyPayment currency
Example: USDT; BTC; ETH
ApplyFeeTotal card application fee (in USDT)
RechargeFeeCard recharge fee (in USDT)
PostagePostage fee (in USDT)
Applies only for Physical cards
OrderTimeOrder timestamp