Create Cardholder

Create cardholder information

Request URL

POST https://card-api-sandbox.pagsmile.com/issuing/holder/create

Request Header

Name
Type
Description

Content-Type*

string

application/json; chartset=UTF-8

Request Body

Refer to : common

Biz_data :

Name
Type
Description

mobile*

string(16)

The whole mobile phone number.

Need to add an international area code

first_name*

string(50)

First name.

last_name*

string(50)

Last name.

id_no*

string(6-20)

ID number.

id_type*

integer

Type of certificate.

issuance_date

string

Issuance date

format:yyyy-MM-dd

expires_on

string

Expires On

format:yyyy-MM-dd

email*

string

Business emailEmails are validated against the rfc6530 standard.

birthday*

string

Date of Birth,

yyyy-MM-dd

gender*

integer

Gender.

nationality_code*

string(2)

Nationality Country code,

refer to CountryCode

address.line*

string(12-128)

The first line of the address.

Format:CHARSETS_4

address.line2

string(128)

The second line of the address.

Format:CHARSETS_4

address.postal_code*

string(4-8)

The address zip code, or postal code.

address.city_name*

string(4-80)

The address city

Format:CHARSETS_6

address.state*

string(4-48)

The address state

Format:CHARSETS_6

address.country_code*

string(2)

The two-letter ISO country code of the address,

refer to CountryCode

Response

{
    "code": "10000",
    "msg": "Success",
    "data": {
        "holder_id": 100061,
        "id_no": "7234559",
        "id_type": 1,
        "audit_status": 3
    },
    "random_key":"abssdddd2wdw==",
    "sign_type": "RSA",
    "app_id": "2017051914172236111"
}
Name
Type
Description

holder_id

long

Cardholder ID.

id_no

string

ID number.

id_type

string

Type of certificate.

audit_status

integer

Audit status,

refer to:CustomerAuditStatus

Example

curl --location --request POST 'https://card-api-sandbox.pagsmile.com/issuing/holder/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "app_id": "2017051914172236111",
    "partner_id":"000000000000001",
    "sub_partner_id":"",
    "timestamp": "2011-09-23 04:24:03",
    "format": "JSON",
    "version": "2.0",
    "random_key": "jJT3+PR9CSowcR2QOK5OzMjVmTSjGoectzYbO8lENHnboElE",
    "request_id": "F6bEd39c-EecF-C1a2-AFcb-bA9BAed1",
    "sign_type": "RSA",
    "biz_data": {
        "mobile": "8512345679",
        "first_name": "fu",
        "last_name": "hello",
        "id_no": "7234559",
        "id_type": 1,
        "email": "123@162.com",
        "birthday": "1990-11-08",
        "gender":1,
        "issuance_date":"2024-07-21",
        "expires_on":"2024-07-24",
        "nationality_code":"BR",
        "address": {
            "city_name": "bbbb",
            "country_code": "BR",
            "postal_code": "25115",
            "state": "proident enim",
            "line": "line11111111111111",
            "line2": "line2 officia adipisicing"
        }
    }
}'

Note: 201************11 is pagsmile's test app id for sandbox

Please use your own app_id when testing.

PreviousCardholderNextUpdate Cardholder

Last updated