Search
K

비 인증 결제(일회성) API

카드정보를 기입하여 1회성 결제를 요청할 수 있습니다.
Deprecated
이 문서는 더 이상 관리되지 않습니다.
PortOne 개발자센터를 이용해주세요.

카드정보만으로 결제를 요청할 수 있습니다.

post
https://api.iamport.kr/subscribe/payments
/onetime
구매자로부터 별도의 인증과정을 거치지 않고 카드정보만으로 결제를 진행하는 API 입니다.

주요 요청 파라미터 상세 설명

merchant_uid * string
주문번호
매 결제요청 시 고유값으로 요청해야 합니다.
card_numb * string
카드번호
카드번호 기재 양식의 유의하세요 (DDDD-DDDD-DDDD-DDDD)
expiry * string
카드 유효기간
유효기간 기입 양식을 유의하세요 (YYYY-MM)
birth * string
생년월일
생년월일 기재 양식 유의**(YYMMDD)** 및 법인카드의 경우 사업자 번호 10자리 기재
(생년월이 기재가 필요 없는 해외PG사 결제 요청의 경우 000000 으로 고정 기재해도 무방)
pg * string
pg 구분코드
관리자콘솔 API 방식 비인증 PG설정이 2개 이상인 경우 필수적으로 기재해야 하는 항목입니다.
동일 PG사에 두개의 MID 를 설정한 경우 아래 양식으로 기재 합니다.
{PG사}.{PG상점아이디}
  • 나이스페이먼츠, JTNet 2가지 PG설정이 되어있다면, pg 파라미터로 nice 또는 jtnet로 구분 가능
  • 나이스페이먼츠로부터 2개 이상의 상점아이디를 발급받았다면, nice.MID1 또는 nice.MID2로 구분 가능
buyer_name * string
**주문자명 **
페이먼트월 PG를 이용하는 경우 구매자명은 first name 과 last name이 한칸 띄어쓰기 형태로 구분되서 유입되어야 합니다.
예시)** Michael Jackson**
customer_uid * string
고객 빌링키
해당 값이 설정되는 경우 빌링키가 해당 값에 맵핑되며 추후 customer_uid 값으로만 결제를 발생시킬 수 있습니다.
Response Model Schema
{
"code": 0,
"message": "string",
"response": {
"imp_uid": "string",
"merchant_uid": "string",
"pay_method": "string",
"channel": "pc",
"pg_provider": "string",
"emb_pg_provider": "string",
"pg_tid": "string",
"pg_id": "string",
"escrow": true,
"apply_num": "string",
"bank_code": "string",
"bank_name": "string",
"card_code": "string",
"card_name": "string",
"card_quota": 0,
"card_number": "string",
"card_type": "null",
"vbank_code": "string",
"vbank_name": "string",
"vbank_num": "string",
"vbank_holder": "string",
"vbank_date": 0,
"vbank_issued_at": 0,
"name": "string",
"amount": 0,
"cancel_amount": 0,
"currency": "string",
"buyer_name": "string",
"buyer_email": "string",
"buyer_tel": "string",
"buyer_addr": "string",
"buyer_postcode": "string",
"custom_data": "string",
"user_agent": "string",
"status": "ready",
"started_at": 0,
"paid_at": 0,
"failed_at": 0,
"cancelled_at": 0,
"fail_reason": "string",
"cancel_reason": "string",
"receipt_url": "string",
"cancel_history": [
{
"pg_tid": "string",
"amount": 0,
"cancelled_at": 0,
"reason": "string",
"receipt_url": "string"
}
],
"cancel_receipt_urls": [
"string"
],
"cash_receipt_issued": true,
"customer_uid": "string",
"customer_uid_usage": "issue"
}
}