다날

JavaScript SDK IMP.request_pay(param, callback)을 호출하여 다날 Tpay 결제창을 호출할 수 있습니다. 결제결과는 PC/모바일 환경 모두 경우 IMP.request_pay(param, callback) 호출 후 callback 으로 수신됩니다.

Javascript SDK
IMP.request_pay(
  {
    channelKey: "{콘솔 내 연동 정보의 채널키}",
    pay_method: "card",
    merchant_uid: "order_no_0001", // 상점에서 생성한 고유 주문번호
    name: "주문명:결제테스트",
    amount: 1004,
    buyer_email: "test@portone.io",
    buyer_name: "구매자이름",
    buyer_tel: "010-1234-5678",
    buyer_addr: "서울특별시 강남구 삼성동",
    buyer_postcode: "123-456",
  },
  function (rsp) {
    // callback 로직
    //* ...중략... *//
  },
);

주요 파라미터 설명

channelKey * string

채널키

결제를 진행할 채널을 지정합니다.

포트원 콘솔 내 [결제 연동] - [연동 정보] - [채널 관리] 에서 확인 가능합니다.

(최신 JavaScript SDK 버전부터 사용 가능합니다.)

pg (deprecated) string

PG사 구분코드

danal_tpay 로 지정하면 됩니다.

pay_method * string

결제수단 구분코드

• card (신용카드)
• trans (실시간 계좌이체)
• vbank(가상계좌)
• phone(휴대폰 소액결제) : 휴대폰 결제인 경우 pg 파라미터는 danal 로 지정하면 됩니다.
• cultureland (문화상품권)
• booknlife (도서문화상품권)

merchant_uid * string

고객사 고유주문번호

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

buyer_tel * string

주문자 연락처

미 설정 시 다날 결제창에서 오류 발생 가능

amount * integer

결제금액

string 이 아닌점에 유의하세요

특정 통신사만 노출
{
  "phone": {
    "detail": [
      {
        "carrier": "*", // 모두 활성화
        "enabled": false
      },
      {
        "carrier": "SKT", // SKT만 활성화
        "enabled": true
      }
    ]
  }
}

2개 이상 통신사 노출
{
  "phone": {
    "detail": [
      {
        "carrier": "SKT",
        "enabled": false
      },
      {
        "carrier": "KTF",
        "enabled": false
      },
      {
        "carrier": "LGT",
        "enabled": false
      },
      {
        "carrier": "CJH",
        "enabled": false
      }
    ]
  }
}
// KCT, SKL 을 제외한 나머지 통신사는 비활성화 됩니다.

특정 통신사만 비노출
{
  "phone": {
    "detail": [
      {
        "carrier": "SKT",
        "enabled": false
      }
    ]
  }
}