💻
Docs
  • Introduction
  • VIRTUAL CARD
    • Page Integration
      • Quick Page Integration
      • Login-free Page Integration
      • About The Sign
      • Explanation of Return Codes
    • API Integration
      • Things Need To Know
      • About The Sign
      • API For Fetching Usable Card Segments
      • API For Retrieve Enumerations Of The States In The United States
      • API For Creating Virtual Card
      • API For Virtual Card Deposit (recharge)
      • API For Obtaining Card Details
      • API For Updating Virtual Card (update cardholder address)
      • API For Card Refund
      • API For Deleting Card
      • API For Querying Order History
      • Successful card opening callback
      • Fail card opening callback (COPY)
      • Risk Control webhook
      • Error Code
  • Physical card
    • Page Integration
      • Page customization
    • API Integration
      • Create Cardholder
      • Modify Cardholder Information
      • Cardholder Document Upload
      • Cardholder Query
      • Bank Card Application
      • Bank Card Application Result Query
      • Bank Card Activation
      • Bank Card Top-up
      • Bank Card Top-up Order Query
      • Bank Card Query
      • Bank Card Transaction Details Query
      • Bank Card Replacement
      • Bank Card Unloss
      • Bank Card Password Retrieval
      • Bank Card Authorized Transaction Details
      • Partner Account Balance Inquiry
      • Partner Top-up Account Information Inquiry
      • Cardholder Audit Result Notification
      • Bank Card Transaction Notification
  • KYC Sharing API
    • Integration Options
    • Signature Description
    • API
      • Submit basic information
      • Upload photo
      • Submit for approval
      • Query Approval Results
      • Approval Results[Webhook]
Powered by GitBook
On this page
  1. Physical card
  2. API Integration

Bank Card Application

POST Bank Card Application

POST /api/mastercard/masterCardApply.html

Bank card application

Request Body Example

{
  "address": "Laisvés pr. 60",
  "cardChannel": 3,
  "cardType": 2,
  "contactMobile": "+8613501167215",
  "contactName": "John Doe",
  "countryCode": "LT",
  "holderId": "100085",
  "orderNo": "12345678901",
  "postCode": "05120",
  "randomStr": "abcdef12345saas67890",
  "town": "Vilnius"
}

Request Parameters

Name
Type
Required
Base64 Encoding
Field Name
Description

orderNo

string

true

none

Order number

Card application order number

holderId

string

true

none

Cardholder ID

Cardholder ID

cardChannel

integer

false

none

Card channel

3 - MasterCard (default: 3)

cardType

integer

true

none

Card type

2 - Personal physical card

countryCode

string

true

none

Country Code

Shipping address, country code (two-letter country code)

town

string

true

Y

European region

Shipping address, city name (in English)

address

string

false

Y

European detailed address

Shipping address, detailed address (in English)

postCode

string

true

none

Postal code

Shipping address, postal code

contactName

string

true

none

Contact person

Shipping address, recipient's name

contactMobile

string

true

none

Contact person mobile

Shipping address, recipient's mobile number

randomStr

string

true

none

Randomstr

A random string of 32 characters

Example Response

200 Response

{
    "applyStatus": 0,
    "errMsg": "string"
}

Response Fields

Name
Type
Required
Constraints
Description

applyStatus

integer

true

none

Application status: 1 - Success, 2 - Failure

errMsg

string

true

none

Status description

Last updated 1 year ago