Card

1.Push events

Event	Repeat	Describe
CC_CONSUME	yes	card consume
CC_REFUND	yes	card refund
CC_WITHDRAW_CASH	yes	Card withdrawal
CC_REDEEM	yes	Card redemption
CC_RECHARGE	yes	Card recharge/mortgage
3DS_OTP	yes	3D Secure Verification Code
3DS_CONFIRM	yes	3DS Confirmation Code
CR_RECHARGE	yes	Notification of successful submission of card recharge application
CA_APPLY	yes	Card application submission successful notification
NE_VERIFY	yes	Verification notification
KS_KYC	yes	KYC Verification
CSC_STATUS_CHANGE	yes	Card status change
MF_MATERIAL_FLOW	yes	Card delivery logistics notice
CS_APPROVED	yes	Card activation success notification

2.Global push format

Parameter	Type	Required	Describe
event	String	true	Event name
trace	String	true	Link ID, the same link ID for the same transaction
orderNo	String	true	Order number, globally unique
timestamp	Long	true	Push timestamp (milliseconds)
detail	Object		The format of push content varies depending on the event

2.1.Card transaction push format

Including card consumption, card refund, card withdrawal, card redemption, card recharge/mortgage

Parameter	Type	Required	Describe
cardId	String	true	Card ID
cardNumber	String	true	Card number
orderNo	String	true	Order Number
customerNo	String	true	Customer number
type	int	true	Transaction type (1=recharge/mortgage, 2=consumption, 3=refund, 4=withdrawal, 5=redemption, 6=management fee)
status	int	true	Transaction status (1=successful, 2=failed, 3=processing, 4=credited, 5=not credited, 6=payment failed, 7=canceled)
amount	BigDecimal	true	Transaction amount
direction	int	true	Income and expenditure direction
merchantName	String	false	Merchant name
currency	String	true	Transaction currency
transactionAt	Long	true	Transaction time
transactionId	String	true	Transaction ID,The TransactionID of the same transaction is consistent
originalAmount	BigDecimal	false	Original transaction amount
originalCurrency	String	false	Original transaction currency
reason	String	false	Cause of failure

2.2. 3DS Data Webhook Format

Parameter	Type	Required	Describe
cardId	String	true	Card ID
cardNumber	String	true	Card number
customerNo	String	true	Customer number
3dsCode	String	true	3DS Code
orderNo	String	true	Order Number

2.3. 3DS Confirm Data Webhook Format

Parameter	Type	Required	Describe
cardId	String	true	Card ID
cardNumber	String	true	Card number
customerNo	String	true	Customer number
validateCode	String	true	3DS Confirm validate code
merchants	String	true	Merchant Name
transactionTime	Long	true	Trading hours
amount	BigDecimal	true	Transaction amount
transactionCurrency	String	true	Trading currency

2.4. Card application submission successful notification push format

Parameter	Type	Required	Describe
cardId	String	true	Card ID
orderNo	String	true	Order Number
customerNo	String	true	Customer number
amount	BigDecimal	true	Actual payment amount
status	Integer	true	Payment Status (1: Paid 2: Pending Payment)
subscribeAt	Long	true	Subscribe time

2.5. Push notification format for successful recharge application submission

Parameter	Type	Required	Describe
cardId	String	true	Card ID
orderNo	String	true	Order Number
customerNo	String	true	Customer number
cardNumber	String	true	Card Number
amount	BigDecimal	true	Actual payment amount
status	Integer	true	Payment Status (8: Pending Payment)
subscribeAt	Long	true	Subscribe time

2.6. Verification notification push format

Parameter	Type	Required	Describe
cardId	String	true	Card ID
orderNo	String	true	Order Number
code	String	true	Verification Code
cardNumber	String	true	Card Number
type	String	true	Type (see 2.7 Verification Notification Type)
customerNo	String	true	Customer Number

2.7. Verification notification type

Parameter	Describe
3DS_CONFIRM_LINK	3DS Confirmation Link
3DS_VERIFICATION_CODE	3D Secure Verification Code
CARD_ACTIVATION	Card Activation
LOCK_UNLOCK_CARD	Card lock/unlock
TX_WDR_PWD_MODIFY	Modify transaction (cash withdrawal) password
TX_WDR_PWD_SET	Set transaction (cash withdrawal) password
CAT_CARD	View Card

2.8. Kyc notification push format

Parameter	Type	Required	Describe
customerNo	String	yes	customer no
documentType	String	yes	document type (1:id card 2:passport 3:living)
status	String	yes	status(1:pass 2:refuse 3:procesing 4:none) Only push 1, 2 final status

2.9. Card status change notification push format

Parameter	Type	Required	Describe
cardId	String	yes	card id
cardNumber	String	yes	card number
status	String	yes	status (1=Normal, 2=To be activated, 3=Frozen, 4=Locked card, 5=Destroyed, 6=Under application, 7=Activating, 8=Locking card, 9=Unlocking, 10=Destroying,13=Rejected,14=Cancelled,15=Replacing,16=Replaced) Only push 1:Normal 2:To be activated 3:Frozen 4:Locked 5:Destroyed 13:Rejected 14:Cancelled final status
orderNo	String	yes	order no
customerNo	String	yes	customer no

2.10. Card delivery logistics notification push format

Parameter	Type	Required	Describe
dispatchTime	String	yes	Delivery time
logisticsOrderNo	String	yes	Logistics tracking number
logisticsCompanyName	String	yes	Logistics Company Name
recipientAddress	String	yes	Shipping address
logisticsImage	String	yes	Logistics photos
cardId	String	yes	Card ID

2.11. Format of push notification for successful card activation

Parameter	Type	Required	Describe
orderNo	String	yes	Order number
cardId	String	yes	Card ID
cardNumber	String	yes	Card number
customerNo	String	yes	Customer number
cardStatus	Integer	yes	Card status