엑심베이
엑심베이 결제 연동 방법을 안내합니다.
1. 엑심베이 채널 설정하기
결제대행사 채널 설정하기 페이지의 내용을 참고하여 채널 설정을 진행합니다.
2.결제 요청하기
JavaScript SDK IMP.request_pay(param, callback)
을 호출하여
엑심베이 결제창을 호출할 수 있습니다. 결제결과는 PC / 모바일 모두 callback 으로 전달됩니다.
Javascript SDKIMP.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
* 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_num
은unknown
으로 고정) - Econtext 로부터 입금확인이 되면 포트원에서 엑심베이로부터 응답을 받아
status: "paid"
로 변경 후 결제완료처리에 대한 웹훅 전송
편의점결제 테스트 진행순서
가상계좌와 같이 실제 고객이 입금한 결과를 테스트해야 하므로 아래와 같이 입금완료됨을 임의적으로 통지받아보실 수 있습니다.
- 엑심베이 테스트모드 ON상태에서 1번과 같이 결제창 진행
- 콜백 응답 중
pg_tid
값을 별도로 메모 (포트원 관리자콘솔 PG사승인번호 컬럼에서 확인 가능) - http://test.econ.ne.jp/site/tuchi_2/tuchi_menu_2.html로 이동 후 계정 로그인
(아이디 :
ectest
/ 비번 :#eg0810#
) - ShopID :
361301
, orderID : 2번에서 확보한 PG사승인번호 입력 - 하단에 있는
登録
버튼 클릭 - 다음 페이지에서 한 번 더
登録
클릭 - 10분 후 결제상태가
status: "paid"
로 바뀌는지 확인 (이 때 입금에 대한 웹훅 발송됨)