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

200:submit successfully

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

400: invalid-signature

{
    "code": "40002",
    "msg": "Business Failed",
    "sub_code": "invalid-signature",
    "sub_msg": "invalid signature"
}

Name	Type	Description
holder_id	long	Cardholder ID.
id_no	string	ID number.
id_type	string	Type of certificate.
audit_status	string	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": "[e-mail]",
        "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.