이 참조는 범용 커머스 프로토콜 (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,
"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 |
객체[ ] | 필수 | 이 거래에 허용되는 결제 수단입니다. |
allowed_payment_methods[].type |
문자열 | 필수 | 지원되는 결제 수단의 유형입니다. 지원되는 값은 CARD, EWALLET입니다. |
allowed_payment_methods[].parameters |
객체 | 선택사항 | CARD 결제 수단을 구성하는 데 필요한 매개변수입니다. type이 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.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 |
객체 | 선택사항 | 결제 사용자 인증 정보가 사용자에게 반환되는 방식을 정의하는 구성입니다. type이 CARD인 경우 이 속성이 필요합니다. |
allowed_payment_methods[].tokenization_specification.type |
문자열 | 필수 |
토큰화 유형입니다.
|
allowed_payment_methods[].tokenization_specification.parameters |
객체 | 필수 |
선택한 토큰화 type에만 적용되는 매개변수입니다.
PAYMENT_GATEWAY의 필수 매개변수는 다음과 같습니다:
DIRECT의 필수 매개변수는 다음과 같습니다.
|
allowed_payment_methods[].processing_specification |
객체 | 선택사항 | 결제를 처리하는 데 필요한 정보를 정의합니다. type이 EWALLET인 경우 이 속성이 필요합니다. |
allowed_payment_methods[].processing_specification.type |
문자열 | 필수 | e월렛 제공업체 유형입니다. 지원되는 값은 SHOPEE_PAY, TOUCH_N_GO입니다. |
allowed_payment_methods[].processing_specification.parameters |
객체 | 필수 |
선택한 e월렛 제공업체에만 적용되는 매개변수입니다.
필수 매개변수는 다음과 같습니다.
|