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.

Configuration

Mandatory

Remarks

Merchant ID

Yes

ID number of the merchant

Activity Number

Yes

UID of the activity

Enable/Disable

Yes

On/Off

Activation Categories

Yes

Virtual Card; Physical Card

Voucher code Usage Conditions

Yes

  • *Card Application**: Full Application Fee
  • *Card Recharge**: Custom amount

Token

No

Token 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 Amount

Yes

Fixed fiat currency amount

Voucher Code Description

No

Front-end display requirements

Activity Time

No

Start time; End time

Voucher code

Yes

Each 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.

Parameter

Description

EventType

WebhookType

EventId

Webhook event ID

webhookSubscribeId

Webhook subscribe ID

data

Returned data

userId

User email

CreateOrderId

Card creation order number

CardType

  1. Virtual card
  2. Physical card

TransactionType

  1. Create card
  2. Deposit

VoucherCode

Voucher code
Example: Ucard_13249scdjckbksfhiuew

PaymentAmount

Amount of digital currency order
(Corresponding recharge token)

PaymentCurrency

Payment currency
Example: USDT; BTC; ETH

ApplyFee

Total card application fee (in USDT)

RechargeFee

Card recharge fee (in USDT)

Postage

Postage fee (in USDT)
Applies only for Physical cards

OrderTime

Order timestamp