JSON 요청 객체

이 참조 페이지에서는 웹사이트에 사용할 Google Pay API 요청 객체 옵션을 설명합니다.

IsReadyToPayRequest

이 객체는 지원되는 결제 수단을 지정합니다.

속성 유형 필요성 설명
apiVersion 숫자 필수 API 주 버전입니다. 이 사양의 값은 2입니다.
apiVersionMinor 숫자 필수 API 부 버전입니다. 이 사양의 값은 0입니다.
allowedPaymentMethods PaymentMethod[] 필수

Google Pay API에서 지원하는 하나 이상의 결제 수단에 대한 지원을 지정합니다.

tokenizationSpecification은 뷰어의 지급 상태를 확인할 필요가 없습니다. 지원되는 각 PaymentMethod에 필요한 모든 parameters 속성을 제공하세요.

existingPaymentMethodRequired 부울 선택사항

true로 설정하면 현재 뷰어가 allowedPaymentMethods에 지정된 하나 이상의 결제 수단으로 지불할 준비가 된 경우 isReadyToPay() 클래스 메서드가 true를 반환합니다.

예시

이 예시에서는 지원되는 모든 카드 네트워크의 결제 카드 및 Android 기기 토큰을 지원하는 방법을 보여줍니다.

{
  "apiVersion": 2,
  "apiVersionMinor": 0,
  "allowedPaymentMethods": [
    {
      "type": "CARD",
      "parameters": {
        "allowedAuthMethods": ["PAN_ONLY", "CRYPTOGRAM_3DS"],
        "allowedCardNetworks": ["AMEX", "DISCOVER", "INTERAC", "JCB", "MASTERCARD", "VISA"]
      }
    }
  ]
}

PaymentDataRequest

이 객체를 사용하여 앱의 Google Pay API 지원을 구성합니다.

속성 유형 필요성 설명
apiVersion 숫자 필수 API 주 버전입니다. 이 사양의 값은 2입니다.
apiVersionMinor 숫자 필수 API 부 버전입니다. 이 사양의 값은 0입니다.
merchantInfo MerchantInfo 선택사항 결제 데이터를 요청하는 판매자에 대한 정보입니다.
allowedPaymentMethods PaymentMethod[] 필수 Google Pay API에서 지원하는 하나 이상의 결제 수단에 대한 지원을 지정합니다.
transactionInfo TransactionInfo 필수 사용자가 거래에 동의했는지 여부에 따른 거래 승인 세부정보입니다. 총 가격 및 가격 상태를 포함합니다.
emailRequired 부울 선택사항 이메일 주소를 요청하려면 true로 설정합니다.
shippingAddressRequired 부울 선택사항 전체 배송지 주소를 요청하려면 true로 설정합니다.
shippingAddressParameters ShippingAddressParameters 선택사항 shippingAddressParameterstrue로 설정되면 배송지 주소 제한을 지정합니다.

예시

다음 예시에서는 지원되는 모든 카드 네트워크의 결제 카드 및 Android 기기 토큰을 지원하는 방법을 보여줍니다. 결제 카드는 example 게이트웨이에 대해 토큰화됩니다. 결제 수단으로 최종 금액인 12.34달러(미화)를 청구하는 요청입니다.

{
  "apiVersion": 2,
  "apiVersionMinor": 0,
  "merchantInfo": {
    "merchantName": "Example Merchant"
  },
  "allowedPaymentMethods": [
    {
      "type": "CARD",
      "parameters": {
        "allowedAuthMethods": ["PAN_ONLY", "CRYPTOGRAM_3DS"],
        "allowedCardNetworks": ["AMEX", "DISCOVER", "INTERAC", "JCB", "MASTERCARD", "VISA"]
      },
      "tokenizationSpecification": {
        "type": "PAYMENT_GATEWAY",
        "parameters": {
          "gateway": "example",
          "gatewayMerchantId": "exampleGatewayMerchantId"
        }
      }
    }
  ],
  "transactionInfo": {
    "totalPriceStatus": "FINAL",
    "totalPrice": "12.34",
    "currencyCode": "USD"
  }
}

MerchantInfo

이 객체는 결제 데이터를 요청하는 판매자에 대한 정보를 제공합니다.

속성 유형 필요성 설명
merchantId 문자열 필수 Google Pay 비즈니스 콘솔에 등록한 후 발급된 Google 판매자 ID입니다. PaymentsClient이 PRODUCTION 환경 속성으로 초기화되는 경우에 필요합니다. 승인 절차 및 Google 판매자 ID를 얻는 방법에 대한 자세한 내용은 프로덕션 액세스 요청을 참조하세요.
merchantName 문자열 선택사항 UTF-8로 인코딩된 판매자 이름입니다. 판매자 이름이 결제 명세서에 렌더링됩니다. TEST 환경에서 또는 판매자가 인식되지 않으면 결제 명세서에 'Pay Unverified Merchant' 메시지가 표시됩니다.
merchantOrigin 문자열 선택사항

요청한 판매자의 정규화된 도메인입니다. 이 문자열은 결제가 시작된 판매자 웹사이트의 호스트 이름이어야 합니다. 사이트에서 Google Pay 결제 버튼을 제공하고 일반적으로 호스팅된 결제 통합을 통해 다른 사이트를 대신하여 결제 정보를 요청할 때 필요합니다.

예시

다음 예시는 merchantName가 있는 merchantInfo 객체를 보여줍니다.

merchantInfo: {
    merchantName: "Example Merchant",
}

PaymentMethod

이 객체는 Google Pay API에서 지원하고 앱에서 허용하는 결제 수단을 하나 이상 지정합니다.

속성 유형 필요성 설명
type 문자열 필수

지원되는 결제 수단의 짧은 식별자입니다. 현재 CARDPAYPAL만 지원되는 항목입니다.

parameters 객체 필수 제공된 결제 수단 유형을 구성하는 데 필요한 매개변수입니다. CARD 결제 수단의 예상 값에 대한 자세한 내용은 CardParameters를 참조하세요. PAYPAL 결제 수단의 예상 값에 대한 자세한 내용은 PAYPALParameters를 참조하세요.
tokenizationSpecification PaymentMethodTokenizationSpecification 선택사항

결제 정보를 받을 계정 또는 복호화 제공업체를 구성합니다.

이 속성은 CARD 결제 수단에 필요합니다.

이 속성이 IsReadyToPayRequest에 포함된 경우에는 아무런 효과가 없습니다.

카드

다음 예시에서는 지원되는 모든 카드 네트워크의 결제 카드 및 Android 기기 토큰을 지원하는 방법을 보여주며 example 게이트웨이를 통한 토큰화를 보여줍니다.

{
  "type": "CARD",
  "parameters": {
    "allowedAuthMethods": ["PAN_ONLY", "CRYPTOGRAM_3DS"],
    "allowedCardNetworks": ["AMEX", "DISCOVER", "INTERAC", "JCB", "MASTERCARD", "VISA"]
  },
  "tokenizationSpecification": {
    "type": "PAYMENT_GATEWAY",
    "parameters": {
      "gateway": "example",
      "gatewayMerchantId": "exampleGatewayMerchantId"
    }
  }
}
PAYPAL

다음 예시는 PAYPAL 결제 수단을 지원하는 방법을 보여줍니다.

{
  “type”: “PAYPAL”,
  parameters: {
  	"purchase_context": {
    	     "purchase_units": [{
        		"payee": {
          		      "merchant_id": "PAYPAL_ACCOUNT_ID"
                      	   }
       	       } ]
  	  }
    },
   “tokenizationSpecification”: {
	type: “DIRECT”  }
}

TokenizationSpecification

이 객체를 사용하면 청구 가능한 결제 정보를 받을 수 있는 계정을 구성할 수 있습니다.

속성 유형 필요성 설명
type 문자열 필수

지정된 PaymentMethod에 결제 수단 토큰화 유형이 지원됩니다. CARD 결제 수단에는 PAYMENT_GATEWAY 또는 DIRECT를 사용합니다. PAYPAL PaymentMethod에는 DIRECT 를 매개변수 없이 사용합니다.

parameters 객체 필수 선택한 결제 수단 토큰화 유형에만 적용되는 매개변수입니다.

게이트웨이

typePAYMENT_GATEWAY로 설정하여 Google Pay API에서 지원하는 결제 게이트웨이에서 결제 및 고객 정보를 검색합니다. 게이트웨이에서 설명한 대로 parameters 속성을 정의합니다. 일반적인 속성에는 Google에서 발급한 게이트웨이 식별자와 게이트웨이에서 제공하는 게이트웨이 계정 ID가 포함됩니다.

다음 예시는 결제 게이트웨이에서 정보를 검색하는 방법을 보여줍니다.

"tokenizationSpecification": {
  "type": "PAYMENT_GATEWAY",
  "parameters": {
    "gateway": "example",
    "gatewayMerchantId": "exampleGatewayMerchantId"
  }
}

다음 표를 참조하여 지원되는 게이트웨이의 "gateway":"gatewayMerchantId": 값을 찾습니다.

게이트웨이 매개변수 및 문서
ACI

  "gateway": "aciworldwide"
  "gatewayMerchantId": "YOUR_ENTITY_ID"

개발자 문서

Adyen

  "gateway": "adyen"
  "gatewayMerchantId": "YOUR_MERCHANT_ACCOUNT_NAME"

개발자 문서

Alfa-Bank

  "gateway": "alfabank"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

APPEX

  "gateway": "epos"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Assist

  "gateway": "assist"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Billing Systems

  "gateway": "billingsystems"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Blue Media

  "gateway": "bluemedia"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

BlueSnap

  "gateway": "bluesnap"
  "gatewayMerchantId": "YOUR_shopToken"

개발자 문서

Braintree

  "gateway": "braintree"
  "braintree:apiVersion": "v1"
  "braintree:sdkVersion": "braintree.client.VERSION"
  "braintree:merchantId": "YOUR_BRAINTREE_MERCHANT_ID"
  "braintree:clientKey": "YOUR_BRAINTREE_TOKENIZATION_KEY"

개발자 문서

Braspag

  "gateway": "cielo"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

CardConnect

  "gateway": "cardconnect"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Cathay United Bank

  "gateway": "cathaybk"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Chase Merchant Services

  "gateway": "chase"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Checkout.com

  "gateway": "checkoutltd"
  "gatewayMerchantId": "YOUR_PUBLIC_KEY"

개발자 문서

CloudPayments

  "gateway": "cloudpayments"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Computop

  "gateway": "computop"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

ConcordPay

  "gateway": "concordpay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Cybersource

  "gateway": "cybersource"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Datatrans

  "gateway": "datatrans"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

dLocal

  "gateway": "dlocal"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Dotpay

  "gateway": "dotpay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

e-SiTef - Software Express

  "gateway": "softwareexpress"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

EasyPay

  "gateway": "easypay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

EBANX

  "gateway": "ebanx"
  "gatewayMerchantId": "YOUR_PUBLIC_INTEGRATION_KEY"

개발자 문서

eCard

  "gateway": "ecard"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

ECPay

  "gateway": "ecpay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서가 없음

eGHL

  "gateway": "eghl"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

eSafe

  "gateway": "esafe"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서가 없음

Evo Payment Gateway

  "gateway": "evopaymentgateway"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서가 없음

Fat Zebra

  "gateway": "fatzebra"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

First Data(Payeezy)

  "gateway": "firstdata"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

FreedomPay

  "gateway": "freedompay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Gestpay

  "gateway": "gestpay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Global One Pay

  "gateway": "globalonepay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서가 없음

Global Payments

  "gateway": "globalpayments"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

GMO Payment Gateway

  "gateway": "gmopg"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

GoPay

  "gateway": "gopay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

GP Webpay

  "gateway": "gpwebpay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서가 없음

HiTrust

  "gateway": "hitrustpay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

iPay88

  "gateway": "ipay88"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

iQmetrix

  "gateway": "iqmetrixpaymentservicesgateway"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

IXOPAY

  "gateway": "ixopay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

JudoPay

  "gateway": "judopay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서가 없음

Kassa

  "gateway": "kassacom"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Kineox

  "gateway": "kineox"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

LogPay

  "gateway": "logpay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Lyra

  "gateway": "lyra"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Mastercard Payment Gateway Services

  "gateway": "mpgs"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

MOBI.Money

  "gateway": "mobimoney"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Molpay

  "gateway": "molpay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서가 없음

Moneris

  "gateway": "moneris"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Moneta

  "gateway": "moneta"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서가 없음

Monext

  "gateway": "monext"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Money.Mail.Ru

  "gateway": "moneymailru"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Multicarta

  "gateway": "mulitcarta"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Mundipagg

  "gateway": "mundipagg"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

MyCheck

  "gateway": "mycheck"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

MyPay

  "gateway": "mypay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서가 없음

Newebpay(이전 STPath, Pay2Go)

  "gateway": "newebpay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Nexi

  "gateway": "nexi"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

NMI

  "gateway": "creditcall"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Nuvei

  "gateway": "nuvei"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Payfacto

  "gateway": "payfacto"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

paygent

  "gateway": "paygent"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

PayLane

  "gateway": "paylane"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Payler

  "gateway": "payler"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Paymark

  "gateway": "paymark"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Paymentwall

  "gateway": "paymentwall"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Paymo

  "gateway": "paymo"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

PayOnline

  "gateway": "payonline"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Paysafe

  "gateway": "paysafe"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Payture

  "gateway": "payture"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

PayU

  "gateway": "payu"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Payway

  "gateway": "payway"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Platon

  "gateway": "platon"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Portmone

  "gateway": "portmonecom"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Przelewy24

  "gateway": "przelewy24"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Radial

  "gateway": "radial"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

RBK.money

  "gateway": "rbkmoney"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Redsys

  "gateway": "redsys"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Sberbank

  "gateway": "sberbank"
  "gatewayMerchantId": "YOUR_ORGANIZATION_NAME"

개발자 문서

Sipay

  "gateway": "sipay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Softbank Payment Service

  "gateway": "sbps"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Solid

  "gateway": "solid"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Sony Payment Services

  "gateway": "sonypaymentservices"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Spreedly

  "gateway": "spreedly"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Square

  "gateway": "square"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Stripe

  "gateway": "stripe"
  "stripe:version": "2018-10-31"
  "stripe:publishableKey": "YOUR_PUBLIC_STRIPE_KEY"

개발자 문서

TapPay(Cherri Tech)

  "gateway": "tappay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Tatra banka(CardPay)

  "gateway": "tatrabanka"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서가 없음

Tinkoff

  "gateway": "tinkoff"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

theMAP

  "gateway": "themap"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

TPay.com

  "gateway": "tpay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Tranzzo

  "gateway": "tranzzo"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Uniteller

  "gateway": "uniteller"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Vantiv

  "gateway": "vantiv"
  "vantiv:merchantPayPageId": "YOUR_PAY_PAGE_ID"
  "vantiv:merchantOrderId": "YOUR_ORDER_ID"
  "vantiv:merchantTransactionId": "YOUR_TRANSACTION_ID"
  "vantiv:merchantReportGroup": "*web"

개발자 문서

Veritrans

  "gateway": "veritrans"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Vindicia

  "gateway": "vindicia"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

WayForPay

  "gateway": "wayforpay"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Windcave

  "gateway": "windcave"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Wirecard

  "gateway": "wirecard"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Worldnet

  "gateway": "worldnet"
  "gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"

개발자 문서

Worldpay

  "gateway": "worldpay"
  "gatewayMerchantId": "YOUR_WORLDPAY_MERCHANT_ID"

개발자 문서

Yandex.Checkout

  "gateway": "yandexcheckout"
  "gatewayMerchantId": "YOUR_SHOP_ID"

개발자 문서

직접 통합

서버에서 직접 응답을 복호화 하려면 typeDIRECT로 설정합니다.

속성 유형 필요성 설명
protocolVersion 문자열 필수 응답에서 예상되는 암호화/서명 프로토콜의 버전입니다. 현재 ECv2가 지원됩니다. 사용 가능한 암호화 및 서명 프로토콜에 대한 자세한 내용은 결제 데이터 암호화 를 참조하세요.
publicKey 문자열 필수 Base64로 인코딩된 타원 곡선 공개 키입니다. 자세한 내용은 판매자 암호화 문서의 암호화 공개 키 형식 섹션을 참조하세요.
예시

  private static JSONObject getDirectTokenizationSpecification()
      throws JSONException, RuntimeException {
    if (Constants.DIRECT_TOKENIZATION_PARAMETERS.isEmpty()
        || Constants.DIRECT_TOKENIZATION_PUBLIC_KEY.isEmpty()
        || Constants.DIRECT_TOKENIZATION_PUBLIC_KEY == null
        || Constants.DIRECT_TOKENIZATION_PUBLIC_KEY == "REPLACE_ME") {
      throw new RuntimeException(
          "Please edit the Constants.java file to add protocol version & public key.");
    }
    JSONObject tokenizationSpecification = new JSONObject();

    tokenizationSpecification.put("type", "DIRECT");
    JSONObject parameters = new JSONObject(Constants.DIRECT_TOKENIZATION_PARAMETERS);
    tokenizationSpecification.put("parameters", parameters);

    return tokenizationSpecification;
  }

Card 매개변수

이 객체를 사용하면 사용할 수 있는 결제 카드 유형을 정의할 수 있습니다. Google은 구성한 옵션에 따라 지급인의 사용 가능한 결제 카드를 필터링합니다.

속성 유형 필요성 설명
allowedAuthMethods 문자열[] 필수

카드 거래를 인증하기 위해 지원되는 필드입니다.

  • PAN_ONLY: 이 인증 방법은 사용자의 Google 계정에 등록되어 저장된 결제 카드와 연결됩니다. 반환된 결제 데이터에는 만료 월 및 만료 연도가 포함된 개인 계좌 번호(PAN)가 포함됩니다.
  • CRYPTOGRAM_3DS: 이 인증 방법은 Android 기기 토큰으로 저장된 카드와 연결됩니다. 반환된 결제 데이터에는 기기에 생성된 3D Secure(3DS) 암호가 포함됩니다.
allowedCardNetworks 문자열 필수

대행업체 및 Google Pay API에서 지원하는 카드 네트워크 목록입니다.

  • AMEX
  • DISCOVER
  • INTERAC
  • JCB
  • MASTERCARD
  • VISA
allowPrepaidCards 부울 선택사항 선불 카드를 지원하지 않으면 false로 설정하세요. 기본값: 선불 카드 클래스는 지정된 카드 네트워크에서 지원됩니다.
allowCreditCards 부울 선택사항(영국 도박 상품 판매자의 경우 필수) 신용카드를 지원하지 않으면 false로 설정하세요. 기본값: 신용카드 클래스가 지정된 카드 네트워크에서 지원됩니다.
billingAddressRequired 부울 선택사항 청구서 수신 주소가 필요하면 true로 설정하세요. 청구서 수신 주소는 거래를 처리하기 위해 필요한 경우에만 요청해야 합니다. 결제 과정에서 추가 데이터를 요청하면 사용자의 불편을 야기하므로 전환율이 낮아질 수 있습니다.
billingAddressParameters BillingAddressParameters 선택사항 billingAddressRequiredtrue로 설정된 경우 반환되는 예상 필드입니다.

카드 예시

다음은 사용 가능한 모든 카드 네트워크 및 카드 인증 방법을 지원하는 방법의 예시입니다.

{
  "allowedAuthMethods": ["PAN_ONLY", "CRYPTOGRAM_3DS"],
  "allowedCardNetworks": ["AMEX", "DISCOVER", "INTERAC", "JCB", "MASTERCARD", "VISA"]
}

BillingAddressParameters

이 객체를 사용하면 요청된 청구서 수신 주소에 추가로 반환되는 입력란을 설정할 수 있습니다.

속성 유형 필요성 설명
format 문자열 선택사항

거래를 완료하는 데 필요한 청구서 수신 주소 형식입니다.

  • MIN: 이름, 국가 코드, 우편번호입니다(기본값).
  • FULL: 이름, 상세 주소, 구/군/시, 주/도, 국가 코드, 우편번호입니다.
phoneNumberRequired 부울 선택사항 거래를 처리하는 데 전화번호가 필요하면 true로 설정합니다.

예시

다음은 속성의 현재 기본값인 청구서 수신 주소의 최소 버전 요청에 대한 예시입니다.

{
  "format": "MIN"
}

ShippingAddressParameters

이 객체는 배송 제한 사항을 설정하는 데 사용됩니다.

속성 유형 필요성 설명
allowedCountryCodes 문자열[] 선택사항 배송이 허용되는 국가의 ISO 3166-1 alpha-2 국가 코드 값입니다. 이 객체를 지정하지 않으면 모든 배송지 주소 국가가 허용됩니다.
phoneNumberRequired 부울 선택사항 제공된 배송지 주소에 전화번호가 필요하면 true로 설정합니다.

예시

다음은 미국에서 배송지 주소를 요청하는 예시입니다.

{
  "allowedCountryCodes": ["US"]
}

TransactionInfo

이 객체는 지급인의 결제 능력을 판단하는 거래를 설명하며 결제 승인 대화상자를 표시하는 데 사용됩니다. 다음 표에서는 객체의 속성을 자세히 보여줍니다.

속성 유형 필요성 설명
currencyCode 문자열 필수 ISO 4217 알파벳 통화 코드입니다.
countryCode 문자열 선택사항(EEA 국가의 경우 필수)

거래가 처리되는 ISO 3166-1 alpha-2 국가 코드입니다. 유럽 경제 지역(EEA) 국가에 기반을 둔 판매자의 경우 필수 항목입니다.

transactionId 문자열 선택사항 트랜잭션 시도를 식별하는 고유한 ID입니다. 판매자는 Google Pay 거래 시도에 기존 ID를 사용하거나 특정한 ID를 생성할 수 있습니다. 이 필드는 Google Transaction Events API에 콜백을 보낼 때 필요합니다.
totalPriceStatus 문자열 필수

사용된 총 가격의 상태입니다.

  • NOT_CURRENTLY_KNOWN: 기능 확인에 사용됩니다. 거래가 EEA 국가에서 처리되는 경우 이 속성을 사용하지 마세요.
  • ESTIMATED: 청구서 수신 주소에 따라 수집된 판매세와 같은 응답 세부정보를 토대로 총 가격이 조정될 수 있습니다.
  • FINAL: 총 가격은 쇼핑객에게 제시된 금액에서 변경되지 않습니다.
totalPrice 문자열 선택사항

필요에 따라 십진수를 소수점 이하 두 자리로 표시하는 거래의 총 금액입니다. totalPriceStatusNOT_CURRENTLY_KNOWN으로 설정되지 않으면 이 필드는 필수 필드입니다.

문자열의 형식은 다음 정규식 형식을 따라야 합니다. ^[0-9]+(\.[0-9][0-9])?$

displayItems DisplayItem[] 선택사항 현재 결제 요청에 사용할 수 있는 모든 요금입니다. 결제 승인 또는 유동 가격 업데이트를 사용하는 경우에만 결제 명세서에 입력됩니다. 결제 승인 또는 유동 가격 업데이트를 지원하는 기능을 구현하는 경우 이 필드는 필수 필드입니다.
totalPriceLabel 문자열 선택사항 표시 항목 내의 총 가격에 대한 맞춤 라벨입니다.
checkoutOption 문자열 선택사항

Google Pay 결제 명세서에 표시되는 제출 버튼 텍스트에 영향을 줍니다.

  • DEFAULT: 표준 텍스트는 지정된 totalPriceStatus에 적용됩니다(기본값).
  • COMPLETE_IMMEDIATE_PURCHASE: 지급인이 선택사항을 확인한 직후 선택한 결제 수단으로 청구됩니다. 이 옵션은 totalPriceStatusFINAL로 설정된 경우에만 사용할 수 있습니다.

최종 가격 예시

다음은 미국 달러로 표시된 최종 가격의 예시입니다.

{
  displayItems: [
    {
      label: "Subtotal",
      type: "SUBTOTAL",
      price: "11.00",
    },
    {
      label: "Tax",
      type: "TAX",
      price: "1.00",
    }
  ],
    currencyCode: "USD",
    countryCode: "US",
    totalPriceStatus: "FINAL",
    totalPrice: "12.00",
    totalPriceLabel: "Total",
    checkoutOption: "DEFAULT",
    newShippingOptions: {
 	    defaultSelectedOptionId: "shipping-001",
      shippingOptions: [
        {
          "id": "shipping-001",
          "label": "Free: Standard shipping",
          "description": "Free Shipping delivered in 5 business days."
        }
      ]
    },
    error: {
   	  reason: "SHIPPING_ADDRESS_UNSERVICEABLE",
      message: "Cannot ship to the selected address",
      intent: "SHIPPING_ADDRESS"
    }
}

PayPal 매개변수

이 객체를 사용하면 PayPal 매개변수를 정의할 수 있습니다.

속성 유형 필요성 설명
purchase_context PurchaseContext 필수 설명에 주문 정보를 사용하세요.

PayPal 예시

다음은 PayPal 결제 수단을 지원하는 방법의 예시입니다.

{
  "purchase_context": {
    "purchase_units": [
      {
        "payee": {
          "merchant_id": "PAYPAL_ACCOUNT_ID"
        }
      }
    ]
  }
}

PurchaseContext

이 객체는 주문 정보를 제공합니다.

속성 유형 필요성 설명
purchase_units PurchaseUnit[] 필수 고객과 판매자 간의 계약을 설명합니다.

PurchaseUnit

이 객체는 PayPal 고객과 PayPal 판매자 간의 계약을 설명합니다. 자세한 내용은 PayPal Order API 문서purchase_unit을 참조하세요.

속성 유형 필요성 설명
payee Payee 필수 이 거래 대금의 수취인입니다.

Payee

이 객체는 대금을 받는 판매자에 대한 정보를 제공합니다. 자세한 내용은 PayPal Orders API 참조 문서에서 payee를 참조하세요.

지원되는 다른 매개변수는 선택적 매개변수를 참조하세요.

PayPal 예시

다음은 PayPal 결제 수단을 지원하는 방법의 예시입니다.

{
  “type”: “PAYPAL”,
  parameters: {
  	"purchase_context": {
    	     "purchase_units": [{
        		"payee": {
          		      "merchant_id": "PAYPAL_ACCOUNT_ID"
                      	   }
       	       } ]
  	  }
    },
   “tokenizationSpecification”: {
	type: “DIRECT”  }
}