⌨️Request billing key API

Requests a billing key with credit card information.

Requests a billing key with the customer's credit card information.

POST https://api.iamport.kr/subscribe/customer/{customer_uid}

Path Parameters

Name	Type	Description
customer_uid*	String(80)	Billing key

Request Body

Name	Type	Description
pg*	String	PG code
card_numb*	String	Credit card number XXXX-XXXX-XXXX-XXXX
expiry*	String	Credit card expiration YYYY-MM
birth	String	6-digit DOB 10-digit business registration number for corporate card
pwd_2digit	String	First 2-digits of credit card password
cvc	String	CVC code
customer_name	String	Card holder
customer_tel	String	Card holder's phone
customer_email	String	Card holder's email
customer_addr	String	Card holder's address
customer_postcode	String	Card holder's zip code
customer_id	String	Customer ID (For Toss Payments only)

200: OK Success

CustomerResponse

code * integer

Response code

0: success, Not 0: check the message

message * string

Response message

A non-zero code includes a message like 'Invalid payment info'.

response (CustomerAnnotation, optional)

CustomerAnnotation

code * integer

Response code

0: success, Not 0: check the message

message * string

Response message

A non-zero code includes a message like 'Invalid payment info'.

customer_uid * string

Customer ID

pg_provider * string

PG code for billing key

pg_id * string

PG merchant ID (MID) for billing key

card_name * string

Credit card name

card_code * string

Credit card code

card_number * string

Masked card number

card_type * string

Credit card type

Not supported in some PGs (returns null)

customer_name * string

Customer name

customer_tel * string

Customer phone

customer_email * string

Customer email

customer_addr * string

Customer address

customer_postcode * string

Customer zip code

inserted * integer

Billing key issued at (UNIX timestamp)

updated * integer

Billing key updated at (UNIX timestamp)

401: Unauthorized Missing or invalid access token

{
    // Response
}

Key request parameter description

pg * string

PG code

When using multiple MIDs for the same PG, specify as PG code.MID.

Example: PG = NHN KCP and site code = IPXC

kcp.IPXC

birth * string

DOB

May be omitted for some PGs upon pre-agreement.

customer_id string

Customer ID

For Toss Payments only

Using this API requires a pre-agreement with the PG.

• You may modify the required card information upon agreement with the PG.

• Special attention to security is required due to using sensitive card information.

• The customer_uid must be unique and issued per customer-card number pair.

Response Model Schema

{
  "code": 0,
  "message": "string",
  "response": {
    "customer_uid": "string",
    "pg_provider": "string",
    "pg_id": "string",
    "card_name": "string",
    "card_code": "string",
    "card_number": "string",
    "card_type": "null",
    "customer_name": "string",
    "customer_tel": "string",
    "customer_email": "string",
    "customer_addr": "string",
    "customer_postcode": "string",
    "inserted": 0,
    "updated": 0
  }

Swagger Test Link

https://api.iamport.kr/#!/subscribe.customer/customer_save