개발자센터
V1
V2

엑심베이

엑심베이 결제 연동 방법을 안내합니다.

1. 엑심베이 PG 설정하기

엑심베이 설정 페이지의 내용을 참고하여 PG 설정을 진행합니다.

2.결제 요청하기

JavaScript SDK IMP.request_pay(param, callback)을 호출하여 엑심베이 결제창을 호출할 수 있습니다. 결제결과PC / 모바일 모두 callback 으로 전달됩니다.

Javascript SDK
IMP.request_pay({ pg: "eximbay.{상점 ID}", pay_method: "card", merchant_uid: "order_no_0001", // 상점에서 관리하는 주문 번호 name: "주문명:결제테스트", amount: 14.20, currency: "USD", // 기본값: USD(원화 KRW는 페이팔 정책으로 인해 지원하지 않음) buyer_email: "test@portone.io", buyer_name: "구매자이름", buyer_tel: "010-1234-5678", buyer_addr: "서울특별시 강남구 삼성동", buyer_postcode: "123-456", popup:false // 팝업창 활성 비활성화 컨트롤 }, function(rsp) { // callback 로직 /* ...중략... */ });

주요 파라미터 설명

pg *string

PG사 구분코드

eximbay 로 지정하면 됩니다.

pay_method * string

결제수단 구분코드

  • 신용카드: card
  • 알리페이 / 알리페이 플러스: alipay (상점아이디 설정에 따라 알리페이 혹은 알리페이 플러스로 호출됩니다. )
  • 해외카드: card
  • 유니온페이: unionpay
  • 텐페이: tenpay
  • 일본 편의점결제(eContext): econtext
  • 위챗페이: wechat
  • 몰페이: molpay

merchant_uid * string

가맹점 고유주문번호

매번 고유하게 채번되어야 합니다.

buyer_tel * string

주문자 연락처

amount * integer

결제금액

string 이 아닌점에 유의하세요

currency string

결제통화코드

  • KRW
  • USD
  • EUR
  • GBP
  • JPY
  • THB
  • SGD
  • RUB
  • HKD
  • CAD
  • AUD
  • CNY
  • TWD
  • MYR
  • VND
  • PHP
  • MNT
  • NZD
  • AED
  • MOP
  • BRL
  • KZT
  • NOK
  • SAR
  • TRY

language string

  • 한국어 : ko
  • 영어 : en
  • 중국어 : zh
  • 일본어 : jp

참고사항

포트원은 엑심베이 정기결제를 지원하지 않습니다.

편의점 결제 테스트 방법

편의점결제 동작 방식

한국의 가상계좌와 같이 결제창 내에서는 등록을 한 다음에 고객에게 이메일 / 문자로 전달되는 화면을 편의점 카운터에서 지불하며 처리합니다.

  • 포트원 내부에서는 pay_method: "vbank" 로 기록됨
  • Econtext 등록이 완료되었다는 콜백함수 및 웹훅 전송 (status: "ready" 상태 / vbank_numunknown으로 고정)
  • Econtext 로부터 입금확인이 되면 포트원에서 엑심베이로부터 응답을 받아 status: "paid"로 변경 후 결제완료처리에 대한 웹훅 전송

편의점결제 테스트 진행순서

가상계좌와 같이 실제 고객이 입금한 결과를 테스트해야 하므로 아래와 같이 입금완료됨을 임의적으로 통지받아보실 수 있습니다.

  1. 엑심베이 테스트모드 ON상태에서 1번과 같이 결제창 진행
  2. 콜백 응답 중 pg_tid 값을 별도로 메모 (포트원 관리자콘솔 PG사승인번호 컬럼에서 확인 가능)
  3. http://test.econ.ne.jp/site/tuchi_2/tuchi_menu_2.html로 이동 후 계정 로그인 (아이디 : ectest / 비번 : #eg0810#)
  4. ShopID : 361301, orderID : 2번에서 확보한 PG사승인번호 입력
  5. 하단에 있는 登録 버튼 클릭
  6. 다음 페이지에서 한 번 더 登録 클릭
  7. 10분 후 결제상태가 status: "paid"로 바뀌는지 확인 (이 때 입금에 대한 웹훅 발송됨)