IAiamport
subscribe

결제 예약 API

customer__uid를 이용하여 비인증 결제 요청을 예약할 수 있는 API입니다.<br>비 인증 결제(빌링키) API를 포트원이 대신 수행하는 개념)<br> 결제 요청에 대한 결과는 notice_url에 설정한 EndPoint URL로 웹훅을 통해 수신(POST request)받을 수 있습니다.<br><br> <ul> <li>기존에 빌링키가 등록된 customer_uid가 존재하는 경우 해당 customer_uid와 해당되는 빌링키로 schedule정보가 예약됩니다.(카드정보 선택사항)</li> <li>등록된 customer_uid가 없는 경우 빌링키 신규 발급을 먼저 진행한 후 schedule정보를 예약합니다.(카드정보 필수사항)</li> <li>예약건 별로 고유의 merchant_uid를 전달해주셔야 합니다.</li> <li>schedules의 상세정보(선택정보) <b> buyer_name, buyer_email, buyer_tel, buyer_addr, buyer_postcode</b> 누락시,<br> <b>customer_uid</b>에 해당되는 <b>customer_name, customer_email, customer_tel, customer_addr, customer_postcode</b> 정보로 대체됩니다.(둘 다 입력시 buyer_* 정보를 우선합니다)</li> <li>슈퍼빌링키의 customer_uid로 요청하는 경우, 결제 시점 해당 스마트 라우팅 그룹 내 채널 비율 설정에 따라 결제를 요청합니다. 특정 빌링키로 결제를 요청하려면 channel_key에 결제를 희망하는 빌링키의 채널 키를 입력해 주세요.</li></ul>

post/subscribe/payments/schedule

Request

Request body application/x-www-form-urlencoded

customer_uidstring required

빌링키와 매핑되며 고객사에서 채번하는 구매자의 결제 수단 식별 고유번호

customer_idstring

string 타입의 구매자 식별 고유번호 (필수 : 토스페이먼츠)

checking_amountinteger

카드정상결제여부 체크용 금액. 결제 직후 자동으로 취소됩니다. (0원으로 설정할 경우 테스트하지 않음)

card_numberstring

카드번호(dddd-dddd-dddd-dddd)

expirystring

카드 유효기간(YYYY-MM)

birthstring

생년월일6자리(법인카드의 경우 사업자등록번호10자리)

pwd_2digitstring

카드비밀번호 앞 2자리

cvcstring

카드 인증번호 (카드 뒷면 3자리, AMEX의 경우 4자리). Paymentwall에서만 사용

channel_keystring
<ul><li>관리자 콘솔의 [연동관리] -> [연동 정보] 메뉴에서 확인할 수 있습니다.</li><li>이미 발급된 빌링키가 존재하고 해당 빌링키가 슈퍼 빌링키인 경우 특정 채널에서 발급된 빌링키를 선택하려는 경우 사용합니다.</li><li>발급된 빌링키가 없는 경우 빌링키 발급 시 사용할 채널을 지정할 때 사용합니다.</li></ul>

Response

정상적으로 예약 등록이 완료되었습니다

codeinteger

0이면 정상적인 조회, 0아닌 값이면 message를 확인해봐야 합니다

messagestring

code값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다

Changes

No recorded changes to this operation across all 1 revision of this API.