키인(수기) 결제

구매자 인증 없이 카드번호 입력만으로 결제가 가능합니다.

Deprecated

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

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

키인결제를 이용하기 위해서는 PG사와 별도 협의가 필요합니다.

키인(수기)결제를 통해 카드정보를 이용하여 1회성 결제요청이 가능합니다.

키인결제의 장점

아래의 예제처럼 가맹점에 따라 카드정보 입력란을 커스터마이징 할 수 있다는 장점이 있습니다.

포트원 이용 가맹점 "링글 잉글리시 에듀케이션"

키인결제의 단점

간편결제 도입으로 인해 매번 카드정보를 기입해야 하는 번거로움이 있는 키인결제는 많이 사용되지 않습니다.

키인결제 구현하기 (서버)

키인결제는 포트원 키인결제(1회성) API 또는 PG창을 이용하여 결제를 요청할 수 있습니다.

아래 예제는 포트원 키인결제 API를 통해 서버에서 실행 가능한 코드입니다.

Node.js

async function requestInstantPayment() {
  // 1. 포트원 API를 사용하기 위한 액세스 토큰 발급 받기
  const signinResponse = await axios({
    url: "https://api.portone.io/v2/signin/api-key",
    method: "post",
    headers: { "Content-Type": "application/json" },
    data: {
      api_key: PORTONE_API_KEY, // 포트원 API Key
    },
  });
  const { access_token } = signinResponse.data;
  
  // 2. 포트원 키인(수기)결제 API 호출
  await axios({
    url: `https://api.portone.io/v2/payments/${UNIQUE_PAYMENT_ID}/instant/pay`,
    method: "post",
    headers: { "Authorization": "Bearer " + access_token },
    data: {
      order_name: "월간 이용권 정기결제"
      is_cultural_expense: false,
      is_escrow: false,
      // 키인(수기)결제 API를 참고해 고객 정보를 채워주세요.
      customer: YOUR_CUSTOMER_INFO,
      total_amount: 8900,
      channel_name: CHANNEL_NAME_HERE,
      // 키인(수기)결제 API를 참고해 카드 / 가상계좌 정보를 채워주세요.
      payment_method_option: PAYMENT_OPTION_HERE,
      currency: "KRW",
    }
  });
  
  // 3. 인증결제 연동하기의 결제검증 API 구현하기를 따라 결제를 검증해주세요.
}