pay
suspend fun payWithBillingKey(paymentId: String, billingKey: String, channelKey: String? = null, orderName: String, customer: CustomerInput? = null, customData: String? = null, amount: PaymentAmountInput, currency: Currency, installmentMonth: Int? = null, useFreeInterestFromMerchant: Boolean? = null, useCardPoint: Boolean? = null, cashReceipt: CashReceiptInput? = null, country: Country? = null, noticeUrls: List<String>? = null, products: List<PaymentProduct>? = null, productCount: Int? = null, productType: PaymentProductType? = null, shippingAddress: SeparatedAddressInput? = null, promotionId: String? = null, bypass: JsonObject? = null): PayWithBillingKeyResponse
빌링키 결제
빌링키로 결제를 진행합니다.
Parameters
payment
결제 건 아이디
billing
빌링키 결제에 사용할 빌링키
channel
채널 키
다수 채널에 대해 발급된 빌링키에 대해, 결제 채널을 특정하고 싶을 때 명시
order
주문명
customer
고객 정보
custom
사용자 지정 데이터
amount
결제 금액 세부 입력 정보
currency
통화
installment
할부 개월 수
use
무이자 할부 이자를 고객사가 부담할지 여부
use
카드 포인트 사용 여부
cash
현금영수증 정보
country
결제 국가
notice
웹훅 주소
결제 승인/실패 시 요청을 받을 웹훅 주소입니다. 상점에 설정되어 있는 값보다 우선적으로 적용됩니다. 입력된 값이 없을 경우에는 빈 배열로 해석됩니다.
products
상품 정보
입력된 값이 없을 경우에는 빈 배열로 해석됩니다.
product
상품 개수
product
상품 유형
shipping
배송지 주소
promotion
해당 결제에 적용할 프로모션 아이디
bypass
PG사별 추가 파라미터 ("PG사별 연동 가이드" 참고)
Throws
결제가 이미 완료된 경우
빌링키가 이미 삭제된 경우
빌링키가 존재하지 않는 경우
요청된 채널이 존재하지 않는 경우
프로모션 할인 금액이 결제 시도 금액 이상인 경우
요청이 거절된 경우
요청된 입력 정보가 유효하지 않은 경우
결제 혹은 본인인증 시도 횟수가 최대에 도달한 경우
PG사에서 오류를 전달한 경우
결제수단이 프로모션에 지정된 것과 일치하지 않는 경우
면세 금액 등 하위 항목들의 합이 전체 결제 금액을 초과한 경우
인증 정보가 올바르지 않은 경우
API 응답이 알 수 없는 형식인 경우