⌨️엑심베이

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

Deprecated

이 문서는 더 이상 관리되지 않습니다.

PortOne 개발자센터를 이용해주세요.

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

  • 위챗 : wechat

  • 알리페이 : alipay

  • 해외카드 : card

  • 유니온페이 : unionpay

  • 텐페이 : tenpay

  • 일본 편의점결제(eContext) : econtext

merchant_uid * string

주문번호

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

buyer_tel * string

주문자 연락처

amount * integer

결제금액

string 이 아닌점에 유의하세요

currency string

결제통화코드

  • KRW

  • USD

  • EUR

  • GBP

  • JPY

  • THB

  • SGD

  • RUB

  • HKD

  • CAD

  • AUD

language string

  • 한국어 : ko

  • 영어 : en

  • 중국어 : zh

  • 일본어 : jp

참고사항

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

편의점 결제 테스트 방법

편의점결제 동작 방식

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

  • 포트원 내부에서는 pay_method : vbank 로 기록됨

  • Econtext 등록이 완료되었다는 콜백함수 및 웹훅 전송 (status : ready 상태 / vbank_num 은 unknown 으로 고정)

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

Last updated