OnlinePay API
V2
V1
V2
V1
  1. Card
  • Introduction
    • Introduction
    • How to Start
    • Country Code
    • Country Info
    • Currency Code
    • Error Code
    • Transfer Order Info Type
    • Transfer Order File Type
    • Per Bank
    • Spei Bank
    • Vietnam Bank
    • V2 Signature Specification
  • Payin
    • Credit Card API
      POST
    • Alipay API
      POST
    • GCash API
      POST
    • WeChat API
      POST
    • PIX API
      POST
    • Crypto API
      POST
    • Union Pay API
      POST
    • SPEI API
      POST
    • SEPA API
      POST
    • Per Transfer API
      POST
    • Cash App API
      POST
    • Google Pay API
      POST
    • Apple Pay API
      POST
    • MONO API
      POST
    • Vietnam Bank API
      POST
    • CheckOut API
      POST
    • CheckOut Payment API
      POST
    • OnRamps API
      GET
  • Payout
    • PER Transfer Payout API
    • Checkout Payout API
    • Card Payout API
    • Bank Account Payout API
    • PIX Payout API
    • PER Transfer Payout API
    • SPEI Payout API
    • CashApp Payout API
    • Checkout Payout API
    • Query Payout Order API
    • Upload SEPA File API
  • Refund
    • Refund API
  • Card
    • Create Cardholder API
      POST
    • Create Card API
      POST
    • Active Card API
      POST
    • Freeze Card API
      POST
    • UnFreeze Card API
      POST
    • Cancel Card API
      POST
    • TopUp Card API
      POST
    • Card Withdraw API
      POST
    • Query Card Balance API
      POST
    • Query Card Info API
      POST
    • Query Card Transaction API
      POST
    • Add VPA Scene API
      POST
    • UploadFile API
      POST
  • Query
    • Query Payout Order API
    • Query Order API
    • QueryOrderList API
    • QueryBalance API
    • QueryOrderAmount API
  • Notify
    • Pay Notify WebHook API
    • Card Notify WebHook API
    • Refund Notify WebHook API
    • Chargeback Notify WebHook API
  • Schemas
    • UserArray
    • CheckStandV2Request
    • ApiResponse
    • PayoutCheckStandV2Request
    • QueryPayOutV2Request
    • V2EncryptedEnvelope
    • V2EncryptedNotification
    • PaymentNotificationPayload
    • ProductParams
    • Category
    • PayoutCheckStandV2Response
    • PaymentNotification
    • QueryPayOutV2Response
    • PayoutQueryResult
    • Pet
    • OrderQueryV2Data
    • PayoutCheckStandV2Data
    • CheckStandV2Response
    • RefundNotificationPayload
    • CheckStandV2Data
    • ChargebackNotificationPayload
    • Tag
    • OrderQueryV2Request
    • OrderQueryV2Response
    • Order
    • User
  1. Card

Create Cardholder API

Testing Env
https://testpay.onlinepay.ai
Testing Env
https://testpay.onlinepay.ai
POST
/v2/card/createCardHolder
Create a cardholder profile with personal and identity information for card issuance.

Request

Header Params

Body Params application/json

Example
{
    "merNo": "104001001",
    "firstName": "John",
    "lastName": "Doe",
    "city": "Los Angeles",
    "country": "US",
    "address": "123 Main St",
    "zipCode": "90001",
    "state": "California",
    "email": "john@example.com",
    "tel": "1234567890",
    "birthday": "1990-01-15",
    "gender": "M",
    "telCode": "+1",
    "idType1": "PASSPORT",
    "idCard1": "E12345678",
    "photoFrontId1": "photo_front_001",
    "photoBackId1": "photo_back_001",
    "idType2": "03",
    "idCard2": "DL123456",
    "photoFrontId2": "photo_front_002",
    "photoBackId2": "photo_back_002",
    "sign": "A1B2C3D4E5F6...",
    "signType": "RSA256",
    "version": "V2.0.0"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://testpay.onlinepay.ai/v2/card/createCardHolder' \
--header 'paymentType: CARD' \
--header 'Referer: https://example.com' \
--header 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...' \
--header 'lang: en-US' \
--header 'orderType;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merNo": "104001001",
    "firstName": "John",
    "lastName": "Doe",
    "city": "Los Angeles",
    "country": "US",
    "address": "123 Main St",
    "zipCode": "90001",
    "state": "California",
    "email": "john@example.com",
    "tel": "1234567890",
    "birthday": "1990-01-15",
    "gender": "M",
    "telCode": "+1",
    "idType1": "PASSPORT",
    "idCard1": "E12345678",
    "photoFrontId1": "photo_front_001",
    "photoBackId1": "photo_back_001",
    "idType2": "03",
    "idCard2": "DL123456",
    "photoFrontId2": "photo_front_002",
    "photoBackId2": "photo_back_002",
    "sign": "A1B2C3D4E5F6...",
    "signType": "RSA256",
    "version": "V2.0.0"
}'

Responses

🟢200OK
application/json
Bodyapplication/json

Example
{
    "code": "00000",
    "message": "SUCCESS",
    "data": {
        "cardHolderNo": "CH20260522001"
    }
}
Modified at 2026-05-26 02:54:05
Previous
Refund API
Next
Create Card API
Built with