Tevau-openApi
    • Get started
    • Signature instructions
    • Transaction description
    • FAQ
    • Exception Codes
    • 01. User
      • 1.1 Create User
        POST
      • 1.2 Query User
        POST
    • 02. KYC
      • 2.1 V1 submits the customer's KYC information
        POST
      • 2.2 Get the URL
        POST
      • 2.3 Query liveness results
        POST
      • 2.4 Query KYC
        POST
      • 2.5 [Sandbox] Simulate KYC Review
        POST
      • 2.6 Create Document File
        POST
      • 2.7 Upload Document Files
        POST
      • 2.8 V2 Submit customer's KYC information
        POST
    • 03. Card
      • 3.1 Create Card
        POST
      • 3.2 Query Card List
        POST
      • 3.3 Adjust Card Balance
        POST
      • 3.4 Card Details
        POST
      • 3.5 Bind Card
        POST
      • 3.6 Close Card
        POST
      • 3.7 Freeze Card
        POST
      • 3.8 Unfreeze card
        POST
      • 3.9 Activate Card
        POST
      • 3.10 Card PAN
        POST
      • 3.11 Card PIN
        POST
      • 3.12 Card Limit
        POST
      • 3.13 Set Card Fee
        POST
      • 3.14 Query Card Fee
        POST
      • 3.15 3DS
        POST
      • 3.16 Update Phone
        POST
      • 3.17 Update Email
        POST
      • 3.19 Query the list of card tokens
        POST
      • 3.20 Activate the card with Google/Apple Token
        POST
      • 3.21 Card transaction limit
        POST
      • 3.22 Check card account transaction history
        POST
    • 04. Query logistics information
      • 4.1 Query Order
    • 05. Prefund
      • 5.1 Prefund Balance
      • 5.2 Query Bill Details
    • 06. Transaction
      • 6.1 Transaction History
      • 6.2 Transaction Details
    • 07. Simulated Trading
      • 7.1 Authorisation
      • 7.2 Clearing
      • 7.3 Refund
      • 7.4 Reversal
      • 7.5 3DS
      • 7.6 Simulate card status
    • 08. Webhook
      • 8.1 KYC Results
      • 8.2 Card Status
      • 8.3 Changes in card balance
      • 8.4 3DS
      • 8.5 Transaction
      • 8.6 Logistics status
      • 8.7 Token Notification
      • 8.9 Risk Control - Notification of Frozen Card Results
      • 8.10 Notification of failure to bind Google and Apple
      • 8.11 Notification of Fund Pool Top-up Arrival
    • Rests
      • [Sandbox] Edit WebHook-Url
      • JIT Authorized Transaction

    Exception Codes

    CodeDescription
    2010000Enterprise does not exist
    2010001User code must not be empty
    2010002Card template ID must not be empty
    2010003Invalid mobile area code format
    2010004Card ID must not be empty
    2010005Card area code must not be empty
    2010006Card mobile number must not be empty
    2010007Card email must not be empty
    2010009Parameter exception
    2010010PIN must not be empty
    2010011PIN must be 4 or 6 digits
    2010012Operating too frequently, please try again later
    2010013This operation is not currently supported for this card
    2010014Postal code length must be between 4 and 10 characters
    2010008Invalid email format
    2020000Card template information does not exist or has been deleted
    2020001Card quantity limit reached, please contact customer service
    2020002Inventory exception, application failed, please contact customer service
    2020003Insufficient inventory, application failed, please contact customer service
    2020004Please complete the billing address for the virtual card
    2020005Card issuance for the same user requires a 5-second interval
    2020006Liveness verification in progress; please wait for the result before applying again — this usually takes a few minutes
    2020007Account is at risk and has been frozen
    2020008Account is at risk and has been closed
    2020009Queried card information does not exist
    2020010User KYC information must not be empty (date of birth, last name, first name, ID number)
    2020011Incorrect customer ID, please contact customer service
    2020012Card balance can only be adjusted when the card is active, frozen, or locked
    2020013User KYC English name must not be Chinese characters or empty
    2020014Please complete the shipping address before activating the card
    2020015Insufficient balance
    2020016Insufficient inventory, application failed, please contact customer service
    2020018A card that is being closed does not allow locking, top-up, or re-closure
    2020019Unsupported country or region
    2020020Failed to obtain transaction fee
    2020021Top-up amount cannot be equal to 0
    2020023The card can only be unfrozen while in the frozen state
    2020024The card can only be frozen while in the active state
    2020025The card can only be unlocked while in the locked state
    20200273DS authorization transaction has expired
    20200283DS authorization transaction requests must be at least 3 seconds apart; do not request too frequently
    2020032Exception updating mobile number
    2020033Exception updating email
    2020037Card type does not exist
    2020038Physical card application failed, please contact customer service
    2020039Virtual card application failed, please contact customer service
    2020040PIN must not contain 3 consecutive digits or 3 repeated digits
    2020041No shipping information found for this order number
    2020042Incorrect physical card activation code
    2020043Incorrect activation status; the card can only be activated after it has been shipped
    2020044Exception retrieving the activation code while activating the physical card
    2020046Exception activating the physical card, please contact customer service
    2020049Card number or activation code must not be empty
    2020050Card binding: activation code has already been used
    2020051No bank card information found; incorrect activation code
    2020052Card binding is only allowed while the card is in "awaiting binding" status
    2020053Exception with the card being closed, please contact customer service
    2020054Card closure: enterprise account exception
    2020055Card closure: card account exception
    2020058Card closure exception, please contact customer service
    2020060Exception activating the physical card, please contact customer service
    2020063Exception binding the card, please contact customer service
    2020066The physical card can only be activated once it has been shipped; please confirm
    2020068Exception activating the card PIN
    2020070Activation status exception, please contact customer service
    2020071Exception querying CardPanHTML
    20200723DS authorization exception
    2020074Binding activation code error: does not match the card number, please confirm
    2020075Card number has already been bound
    2020076Shipment or third-party card number does not exist
    2020078Failed to retrieve user KYC information, please confirm
    2020079Card is not in a frozen, locked, or active state
    2020083Invalid card fee configuration parameters: failedAuthFixedAmount and zeroAuthFixedAmount must be non-negative numbers, and are only valid when chargeItem=1 (authorization fee)
    2020081Virtual cards do not support PIN modification
    2020082The current card status does not support PIN modification
    2020091Incorrect PIN
    2020092Customer information exception
    20200933DS record does not exist
    2020094Card issuance service exception, please contact customer service
    2020096Card activation token exception, please contact customer service
    2020097Token status must be INACTIVE before it can be activated
    2020102Address contains illegal special characters; cannot contain < > & ' " { } : ; =
    2040001The card scheme is undergoing a system upgrade; please try again later
    2040002Card application failed, please contact customer service
    2040004Card freeze/unfreeze failed, please contact customer service
    2040005Card lock failed, please contact customer service
    2040006Card unlock failed, please contact customer service
    2040007Card destruction failed, please contact customer service
    2040008Failed to create top-up card order, please contact customer service
    2040009Failed to top up card user account, please contact customer service
    2040010Card closure: enterprise account exception
    2040011Card closure: card account exception
    2040012Exception creating the card destruction account order
    2040013Business exception, please contact the platform technical team
    2050001Card does not exist
    2050002Virtual cards do not support identity information updates
    2050002Card has been closed
    2050003Card has not yet been shipped
    2050004Card identity information has already been confirmed
    1001000Invalid API key
    1002000Missing x-nexus-api-key request header parameter
    1003000Rate limit exceeded
    1004000Gateway throttling
    1005000Gateway rate-limiting service exception
    1006000IP address is not in the whitelist
    1007000Missing token parameter
    1008000Token parameter has expired
    10010001Invalid API key
    10010002Invalid request encryption parameters
    10010003Signature error
    3010001Request parameter is empty
    3010002Query quantity exceeds 100
    3010003Queried card number does not exist
    3010004Card is not in a frozen, locked, or active state
    1070004Unsupported request protocol, value is {0}
    1070006Incorrect event type: {0}
    8010001Request parameter is empty
    8010002Invalid or empty email format when creating customer
    8010003Invalid link
    8010005ID document information must not be empty
    8010006Under 18 years old
    8010008Chinese-language documents must be a visa
    8010009Incomplete visa information
    8010010Incorrect country code
    8010011ID document file size exceeds the limit; please refer to the documentation for limits
    8010012Name must not contain Chinese characters
    8010013Invalid file business type
    8020001Current user already exists
    8020002Failed to create user, please try again
    8020003User information does not exist
    8020004KYC verification already passed; please do not resubmit
    8020005Submission failed: retry limit exceeded
    8020006KYC review did not pass
    8020007Records under review or already approved cannot be re-verified
    8020008File information exception
    8020009Please complete identity verification first
    8020010System error, please try again
    8020011Operating too frequently, please try again later
    8020012Invalid endpoint
    8020013Review record does not exist
    8020014This record cannot be reviewed
    8020015Country or region is banned
    8020016Length must be at least 11 characters
    8020017Document providers: 1. SUMSUB, 2. MYINFO, 3. JUMIO, 4. DIDIT, 5. SHUFTI
    8020018Sensitive unique identifier submitted for KYC
    Modified at 2026-08-25 08:39:21
    Previous
    FAQ
    Next
    1.1 Create User
    Built with