💻
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

Cardholder Document Upload

POST Cardholder Document Upload

POST /api/mastercard/holderPhotoUpload.html

Document upload status: 1 - Upload successful, 2 - Upload failed

Request Body

{
  "holderId": "1234567890",
  "photoData": "https://pic.rmb.bdstatic.com/bjh/down/55ae8d25de40edd2eef89fb7f64ed644.png",
  "photoType": "3",
  "randomStr": "abcdef12345ssss67890ssss"
}

Request Parameters

Name
Type
Required
Base64 Encoding
Field Name
Description

holderId

string

true

none

Cardholder ID

The ID of the cardholder

photoType

integer

true

none

Type

1 - ID card front, 2 - ID card back, 3 - Passport, 5 - Proof of address, 8 - Facial photo

photoData

string

true

Y

Photo Data

Photo data (base64-encoded string, maximum 1MB)

randomStr

string

true

none

Randomstr

A random string of 32 characters

Example Response

200 Response

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

Response Fields

Name
Type
Required
Constraints
Description

errMsg

string

true

none

Status description

uploadStatus

integer

true

none

1 - Upload successful, 2 - Upload failed

Last updated 1 year ago