Card

This guide defines the specific enumerations used for card operations. It includes transaction types that describe the nature of funds movement and reason codes that explain the outcome of card-related activities.

Card Transaction Type Enum

This enumeration identifies the nature of a transaction occurring on a card. These values help differentiate between standard purchases, reversals, and internal account adjustments.

Enum ValueDescription
transfer_inCard account transfer in card.
transfer_outCard transfer out to card account.
consumptionA transaction was made on the credit card.
refundAfter the credit card transaction, this order was refunded, or a refund occurred for a previous transaction, which was credited back to the current credit card.
settlement_debitFor example, if $10 was pre-paid for a ride on Uber, but the final settlement deducted $15, the platform will generate an order with a difference of $5.
settlement_refundFor example, if $10 was pre-paid for a ride on Uber, but the final settlement deducted $8, the platform will generate an order with a difference of $2.
reversalThe logic is consistent with a refund, but this type of order often occurs before the order settlement.
declined_refundIn some cases, if our platform successfully authorizes a transaction, a charge will be generated. However, if the order fails due to issues with the bank or other processing errors, we will create a new order to refund the charge.
auth_feeAuthorization Fee.

Transaction Reason Code Enum Definition

The following codes are used to provide specific reasons for transaction outcomes, particularly when a transaction is declined or requires manual intervention.

Reason CodeMessageDescription
100001Insufficient balanceThe account balance is not enough.
100002Card status not activatedThe card has not been activated.
100003Prohibited MCC transactionThe transaction involves a banned MCC.
100004Transaction scenario risk control rejectionThe transaction was rejected due to risk control.
100005Transaction scenario blacklistedThe transaction scenario is blacklisted.
100006Transaction scenario not in whitelistThe transaction scenario is not in the whitelist.
100007System service exceptionThere is an exception in the system service.
100008Unknown declineThe transaction was declined for unknown reasons.
100009Forced debitA forced debit has been applied.
100010Delete card refundThe refund is related to a deleted card.
100011Shared group unavailableThe shared group is not available.
100012Customer authorization rejectedThe customer authorization was rejected.
100013Split transaction settlementThe transaction needs to be settled in parts.
100014Negative card repaymentRepayment for a negative card amount.
100015CVV mismatchThe CVV code does not match.
100016Limit exceededThe transaction exceeds the allowed limit.