Query Corporation Cardholder

Create Corporation Cardholder

Request URL

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

Request Header

Name
Type
Description

Content-Type*

string

application/json; charset=UTF-8

Request Body

Refer to : common

Biz_data :

Name
Type
Description

holder_id

long

Corporation Holder ID

registration_country

string(2)

Registration Country

registration_code

string(32)

Registration Code

Choose one of holder_id and 【registration_country、registration_code】

Response

{
    "code": "10000",
    "msg": "Success",
    "data": {
        "holder_id": 100438,
        "contact_name": "xxxs",
        "mobile": "+86182112140xx",
        "email": "123@163.com",
        "status": 1,
        "corporation": {
            "corporation_id": 100139,
            "registration_name": "tiantong",
            "registration_code": "5r4812q",
            "vat_code": "vatcode12",
            "expires_on": "2012-12-10",
            "business_scope": "to build the connection of payment",
            "registration_address": {
                "address_id": 100945,
                "city_name": "beijing",
                "country_code": "BR",
                "postal_code": "765178",
                "state": "proident enim",
                "line": "Sfcttvc Eqwbsiwn Btyscv Ikdkczsagy Jdywffy Fndhnen Mgfluewrc Tzwypruxp",
                "line2": "Lsje Kijv Rueddokavm Hsrqw Brwtsb Nznxitlbm Zrkovzof Yilmpefnx Nksdqr "
            }
        },
        "person": {
            "person_id": 100516,
            "last_name": "Jane",
            "first_name": "Killy",
            "national_name": "rpc",
            "gender": 1,
            "citizenship_country": "MX",
            "birthday": "2021-12-09",
            "id_type": 1,
            "id_no": "123456",
            "issuance_date": "2012-12-10",
            "expires_on": "2012-12-10",
            "address": {
                "address_id": 100944,
                "city_name": "beijing",
                "country_code": "BR",
                "postal_code": "667344",
                "state": "proident enim",
                "line": "Lvpapei Oxmtmnj Icmttfl Srbf Bvfefb Jfi Phsdk Zgpoaif Mtqsbkc Ykrtpvg ",
                "line2": "Zgw Mlprope Klbukksfse Ivhtlrvvf Yfivejsr Gbcahh Susrscruje Aqkh Eyv R"
            }
        },
        "create_time": "2024-12-26 11:26:14"
    },
    "total": 1,
    "sign_type": "RSA",
    "app_id": "17199901968975887"
}
Name
Type
Description

holder_id*

long

Corporation Holder ID

contact_name*

string(100)

Contact Name

mobile*

string(16)

The whole mobile phone number.

Need to add an international area code

email*

string(80)

Email

corporation.corporation_id*

long

Corporation ID

corporation.registration_name*

string(100)

Registration Name

Format:CHARSETS_7

corporation.registration_code*

string(32)

Registration Code

corporation.registration_date*

string(20)

Registration Date

Format: yyyy-MM-dd

corporation.vat_code

string(32)

VAT Code

corporation.expires_on

string(20)

Expires On

Format: yyyy-MM-dd

corporation.business_scope

string(300)

Business Scope

corporation.registration_address.address_id*

long

Address ID

corporation.registration_address.line*

string(128)

The first line of the address.

Format:CHARSETS_4

corporation.registration_address.line2

string(128)

The second line of the address.

Format:CHARSETS_4

corporation.registration_address.postal_code*

string(4-8)

The address zip code, or postal code

corporation.registration_address.city_name*

string(4-80)

The address city

Format:CHARSETS_6

corporation.registration_address.state*

string(4-48)

The address state

Format:CHARSETS_6

corporation.registration_address.country_code*

string(2)

Country code,

refer to CountryCode

person.person_id*

long

Person ID

person.first_name*

string(50)

Director

First Name

person.last_name*

string(50)

Director

Last Name

person.middle_name

string(50)

Director

Middle Name

person.national_name

string(50)

Director

National Name

person.id_type*

integer

Director

ID Type

person.id_no*

string(6-20)

Director

ID Number

person.birthday*

string(20)

Director

Birthday

Format: yyyy-MM-dd

person.issuance_date

string(20)

Director

Issuance Date

Format: yyyy-MM-dd

person.expires_on

string(20)

Director

Expires On

Format: yyyy-MM-dd

person.citizenship_country*

string(2)

Director

Citizenship Country

person.address.address_id*

long

Address ID

person.address.line*

string(128)

Director

The first line of the address.

Format:CHARSETS_4

person.address.line2

string(128)

Director

The second line of the address.

Format:CHARSETS_4

person.address.postal_code*

string(4-8)

Director

The address zip code, or postal code

person.address.city_name*

string(4-80)

Director

The address city

Format:CHARSETS_6

person.address.state*

string(4-48)

Director

The address state

Format:CHARSETS_6

person.address.country_code*

string(2)

Director

Country code,

Refer to CountryCode

Example


curl --location --request POST 'https://card-api-sandbox.pagsmile.com/issuing/holder/query-corporation' \
--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.

PreviousUpdate Corporation CardholderNextPartner

Last updated