이 참조는 범용 커머스 프로토콜 (UCP)의 Google Pay 결제 핸들러에 대한 구성 객체 스키마를 기반으로 합니다.
{
"api_version": 2,
"api_version_minor": 0,
"environment": "TEST" | "PRODUCTION",
"merchant_info": {
"merchant_id": string,
"merchant_name": string,
"merchant_origin": string,
"auth_jwt": string
},
"allowed_payment_methods": [
{
"type": "CARD",
"parameters": {
"allowed_auth_methods": [
"PAN_ONLY"
],
"allowed_card_networks": [
"AMEX" | "DISCOVER" | "ELECTRON" | "ELO" | "ELO_DEBIT" | "INTERAC" | "JCB" | "MAESTRO" | "MASTERCARD" | "VISA"
],
"allow_prepaid_cards": boolean,
"allow_credit_cards": boolean,
"assurance_details_required": boolean,
"billing_address_required": boolean,
"billing_address_parameters": {
"format": "MIN" | "FULL" | "FULL-ISO3166",
"phone_number_required": boolean
}
},
"tokenization_specification": {
"type": "PAYMENT_GATEWAY" | "DIRECT",
"parameters": {
...
}
}
}
]
}
속성
| 속성 | 유형 | 필요성 | 설명 |
|---|---|---|---|
api_version |
정수 | 필수 | 주 Google Pay API 버전입니다. 2만 지원됩니다. |
api_version_minor |
정수 | 필수 | Google Pay API 부 버전입니다. 0만 지원됩니다. |
environment |
문자열 | 필수 |
사용할 Google Pay 환경입니다.
|
merchant_info |
객체 | 필수 | 판매자의 신원 세부정보입니다. |
merchant_info.merchant_id |
문자열 | 필수 | Google Pay 및 월렛 콘솔의 Google Pay 판매자 ID입니다. PRODUCTION 환경에 필요합니다. 선택사항이며 TEST 환경에서는 무시됩니다. |
merchant_info.merchant_name |
문자열 | 선택사항 | 판매자의 사용자 대상 비즈니스 이름입니다. |
merchant_info.merchant_origin |
문자열 | 선택사항 | 결제가 발생하는 정규화된 웹 도메인입니다 (형식: hostname). |
merchant_info.auth_jwt |
문자열 | 선택사항 | 특정 통합 컨텍스트의 승인 JWT입니다. |
allowed_payment_methods |
object[ ] | 필수 | 이 거래에 허용된 결제 수단입니다. |
allowed_payment_methods[].type |
문자열 | 필수 | 지원되는 결제 수단의 유형입니다. CARD만 지원됩니다. |
allowed_payment_methods[].parameters |
객체 | 필수 | CARD 결제 수단을 구성하는 데 필요한 매개변수입니다. |
allowed_payment_methods[].parameters.allowed_auth_methods |
문자열[ ] | 필수 |
카드 거래를 인증하기 위해 지원되는 필드입니다.
|
allowed_payment_methods[].parameters.allowed_card_networks |
문자열[ ] | 필수 |
판매자가 지원하는 카드 네트워크입니다.
지원되는 값: AMEX, DISCOVER, ELECTRON, ELO, ELO_DEBIT, INTERAC, JCB, MAESTRO, MASTERCARD, VISA
|
allowed_payment_methods[].parameters.allow_prepaid_cards |
부울 | 선택사항 | 선불 카드를 지원하지 않으면 false로 설정하세요. 기본값은 true입니다. |
allowed_payment_methods[].parameters.allow_credit_cards |
부울 | 선택사항 | 신용카드를 지원하지 않으면 false로 설정하세요. 기본값은 true입니다. |
allowed_payment_methods[].parameters.assurance_details_required |
부울 | 선택사항 | 카드 보증 세부정보를 요청하려면 true로 설정합니다. |
allowed_payment_methods[].parameters.billing_address_required |
부울 | 선택사항 | 거래를 완료하는 데 청구서 수신 주소가 필요한 경우 true로 설정합니다. |
allowed_payment_methods[].parameters.billing_address_parameters |
객체 | 선택사항 | 반환된 청구서 수신 주소를 구성하는 매개변수입니다. |
allowed_payment_methods[].parameters.billing_address_parameters.format |
문자열 | 선택사항 |
거래를 완료하는 데 필요한 청구서 수신 주소 형식입니다.
|
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required |
부울 | 선택사항 | 거래를 완료하는 데 전화번호가 필요하면 true로 설정합니다. |
allowed_payment_methods[].tokenization_specification |
객체 | 필수 | 결제 사용자 인증 정보가 반환되는 방식을 정의하는 구성입니다. |
allowed_payment_methods[].tokenization_specification.type |
문자열 | 필수 |
토큰화 유형입니다.
|
allowed_payment_methods[].tokenization_specification.parameters |
객체 | 필수 |
선택한 토큰화 type에만 적용되는 매개변수입니다.
PAYMENT_GATEWAY의 경우 필수 매개변수는 다음과 같습니다.
DIRECT의 경우 필수 매개변수는 다음과 같습니다.
|