엑심베이

채널 설정하기

• 결제대행사 채널 설정하기 페이지의 내용을 참고하여 채널 설정을 진행합니다.
• V2 결제 모듈을 사용하시려면 엑심베이 신모듈로 연동하셔야 합니다.

해외결제 차지백 웹훅 등록

• 해외결제 차지백 웹훅을 수신하기 위해서는 엑심베이에 웹훅 URL로 https://tx-gateway-service.prod.iamport.co/eximbay-v2를 등록해 주셔야 합니다.
• 웹훅 URL을 등록하신 후 받으신 Secret Key를 채널 정보에 입력해 주세요.

결제 창 호출

브라우저 SDK의 PortOne.requestPayment 함수를 사용해 결제창을 호출합니다. 엑심베이 연동만을 위한 파라미터는 브라우저 SDK 파라미터 목록의 bypass.eximbay_v2 항목을 참조해 주세요.

가능한 결제수단

엑심베이의 경우 포트원의 결제수단 구분과 상관없이 여러 결제수단을 표시할 수 있습니다. 따라서 항상 payMethod는 CARD로 설정하고, bypass.eximbay_v2를 사용해 결제수단을 설정해야 합니다.

• MID에 설정된 기본 결제수단을 전부 표시하려면 bypass.eximbay_v2.payment를 생략해야 합니다.
• 특정 결제수단을 단독으로 표시하려면 bypass.eximbay_v2.payment.payment_method를 설정합니다.
• 일부 결제수단만을 표시하려면 bypass.eximbay_v2.payment.multi_payment_method에 결제수단 목록을 전달합니다.
• 엑심베이의 결제수단 코드는 포트원 코드와 상이하므로, EXIMBAY Docs에서 확인 후 입력해야 합니다.

유의사항

• products 입력 시 link를 필수로 입력해야 합니다.

• 네이버페이 포인트로 결제할 경우에는 bypass.eximbay_v2.tax 내용을 모두 입력해야 합니다.

• 계좌이체 사용 시에는 현금영수증 발급을 위해 반드시 bypass.eximbay_v2.tax.receipt_status를 Y로 입력해야 합니다.

• bypass.eximbay_v2.payment_method에 일본 편의점 결제를 지정할 경우 customer.phoneNumber을 필수로 입력해야 합니다.

• 간편결제 사용 시 products를 필수로 입력해야 합니다.

• 아래 결제수단의 경우 사용이 제한되므로 결제 연동 시 유의해 주시기 바랍니다.

  • 가상계좌(P305) : 호환성 이슈로 추후 지원 예정
  • Klarna(P197) : 엑심베이 정책에 따라 신규 결제 사용 불가

• 모바일 앱 내에서 결제를 연동할 경우 appScheme 파라미터를 설정하고 bypass.eximbay_v2.settings.call_from_app 파라미터를 "Y"로 설정해야 합니다.