⌨️엑심베이

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

Deprecated

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

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

결제통화코드

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

Previous연동 유의사항 Next블루월넛

Last updated 1 year ago

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 로직 //* ...중략... *// });