3.1 Create Card

POST

/openapi/card/submitCard

This interface can be used to apply for a virtual card or a physical card online. UserCode is limited every five seconds.
If it is a physical card, the delivery address is required for delivery. If it is a virtual card, the billing address is required.
Applying for a physical card online will not return the cardId. The platform needs to call back the cardId to the access party after delivery.

Request

Header Params

Body Params application/json

Example

{
    "userCode": "CB14837342",
    "cardCode": 1004,
    "dialCode": "852",
    "phoneNumber": "12345678",
    "email": "123456@gmail.com",
    "billingAddress": {
        "address": "Room 001 How Ming Street Kwun Tong Kowloon",
        "countryArea": "HKG",
        "city": "HongKong",
        "postCode": "123456"
    },
    "postalAddress": {
        "address": "Room 001 How Ming Street Kwun Tong Kowloon",
        "firstName": "Jack",
        "lastName": "Wang",
        "countryArea": "HK",
        "city": "HongKong",
        "postCode": "123456",
        "province": "province",
        "recipientTitle": "recipientTitle"
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-test.tevaupay.com/openapi/card/submitCard' \
--header 'x-nexus-api-key;' \
--header 'versions;' \
--header 'appId;' \
--header 'timestamp;' \
--header 'nonce;' \
--header 'sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userCode": "CB14837342",
    "cardCode": 1004,
    "dialCode": "852",
    "phoneNumber": "12345678",
    "email": "123456@gmail.com",
    "billingAddress": {
        "address": "Room 001 How Ming Street Kwun Tong Kowloon",
        "countryArea": "HKG",
        "city": "HongKong",
        "postCode": "123456"
    },
    "postalAddress": {
        "address": "Room 001 How Ming Street Kwun Tong Kowloon",
        "firstName": "Jack",
        "lastName": "Wang",
        "countryArea": "HK",
        "city": "HongKong",
        "postCode": "123456",
        "province": "province",
        "recipientTitle": "recipientTitle"
    }
}'

Responses

🟢200

application/json

Body

Example

{
    "code": 0,
    "msg": "SUCCESS",
    "data": {
        "cardId": "CIDP012954903239",
        "orderNo": "CA2505231726137808965"
    },
    "ok": true
}

🟠404

Modified at 2025-07-28 10:11:06

2.4 Query KYC

3.2 Query Card List