엑심베이

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

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

merchant_uid * string

가맹점 고유주문번호

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

buyer_tel * string

주문자 연락처

amount * integer

결제금액

string 이 아닌점에 유의하세요

currency string

결제통화코드

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"로 바뀌는지 확인 (이 때 입금에 대한 웹훅 발송됨)