Thông tin tham chiếu này dựa trên giản đồ đối tượng config cho trình xử lý thanh toán Google Pay cho Giao thức thương mại toàn cầu (UCP).
{
"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": {
...
}
},
}
]
}
Thuộc tính
| Thuộc tính | Loại | Sự cần thiết | Mô tả |
|---|---|---|---|
api_version |
số nguyên | Bắt buộc | Phiên bản chính của Google Pay API. Chỉ hỗ trợ 2. |
api_version_minor |
số nguyên | Bắt buộc | Phiên bản phụ của Google Pay API. Chỉ hỗ trợ 0. |
environment |
chuỗi | Bắt buộc |
Môi trường Google Pay để sử dụng.
|
merchant_info |
đối tượng | Bắt buộc | Thông tin chi tiết về danh tính của người bán. |
merchant_info.merchant_id |
chuỗi | Bắt buộc | Mã người bán Google Pay của bạn trong Bảng điều khiển Google Pay và Wallet. Đây là yêu cầu bắt buộc đối với môi trường PRODUCTION. Đây là thông số không bắt buộc và sẽ bị bỏ qua trong môi trường TEST. |
merchant_info.merchant_name |
chuỗi | Không bắt buộc | Tên doanh nghiệp mà người dùng nhìn thấy của người bán. |
merchant_info.merchant_origin |
chuỗi | Không bắt buộc | Miền web đủ điều kiện nơi diễn ra quy trình thanh toán (định dạng: hostname). |
merchant_info.auth_jwt |
chuỗi | Không bắt buộc | JWT uỷ quyền cho một số bối cảnh tích hợp. |
allowed_payment_methods |
object[ ] | Bắt buộc | Các phương thức thanh toán được phép dùng cho giao dịch này. |
allowed_payment_methods[].type |
chuỗi | Bắt buộc | Loại phương thức thanh toán được hỗ trợ. Các giá trị được hỗ trợ: CARD, EWALLET. |
allowed_payment_methods[].parameters |
đối tượng | Không bắt buộc | Các tham số cần thiết để định cấu hình phương thức thanh toán CARD. Bạn phải cung cấp thuộc tính này nếu type là CARD. |
allowed_payment_methods[].parameters.allowed_auth_methods |
chuỗi[ ] | Bắt buộc |
Các trường được hỗ trợ để xác thực giao dịch bằng thẻ.
|
allowed_payment_methods[].parameters.allowed_card_networks |
chuỗi[ ] | Bắt buộc |
Các mạng lưới thẻ mà người bán hỗ trợ.
Các giá trị được hỗ trợ: AMEX, DISCOVER, ELECTRON, ELO, ELO_DEBIT, INTERAC, JCB, MAESTRO, MASTERCARD, VISA.
|
allowed_payment_methods[].parameters.allow_prepaid_cards |
boolean | Không bắt buộc | Đặt thành false nếu bạn không hỗ trợ thẻ trả trước. Giá trị mặc định là true. |
allowed_payment_methods[].parameters.allow_credit_cards |
boolean | Không bắt buộc | Đặt thành false nếu bạn không hỗ trợ thẻ tín dụng. Giá trị mặc định là true. |
allowed_payment_methods[].parameters.billing_address_required |
boolean | Không bắt buộc | Đặt thành true nếu bạn yêu cầu địa chỉ thanh toán để hoàn tất giao dịch. |
allowed_payment_methods[].parameters.billing_address_parameters |
đối tượng | Không bắt buộc | Các tham số định cấu hình địa chỉ thanh toán được trả về. |
allowed_payment_methods[].parameters.billing_address_parameters.format |
chuỗi | Không bắt buộc |
Bạn phải cung cấp địa chỉ thanh toán theo đúng định dạng để hoàn tất giao dịch.
|
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required |
boolean | Không bắt buộc | Đặt thành true nếu bạn yêu cầu phải có số điện thoại để hoàn tất giao dịch. |
allowed_payment_methods[].tokenization_specification |
đối tượng | Không bắt buộc | Cấu hình xác định cách thông tin thanh toán được trả về cho bạn. Bạn phải cung cấp thuộc tính này nếu type là CARD. |
allowed_payment_methods[].tokenization_specification.type |
chuỗi | Bắt buộc |
Loại mã hoá.
|
allowed_payment_methods[].tokenization_specification.parameters |
đối tượng | Bắt buộc |
Các thông số dành riêng cho quy trình mã hoá type đã chọn.
Đối với PAYMENT_GATEWAY, các tham số bắt buộc là:
DIRECT, các tham số bắt buộc là:
|
allowed_payment_methods[].processing_specification |
đối tượng | Không bắt buộc | Xác định thông tin cần thiết để xử lý khoản thanh toán. Bạn phải cung cấp thuộc tính này nếu type là EWALLET. |
allowed_payment_methods[].processing_specification.type |
chuỗi | Bắt buộc | Loại nhà cung cấp ví điện tử. Các giá trị được hỗ trợ: SHOPEE_PAY, TOUCH_N_GO. |
allowed_payment_methods[].processing_specification.parameters |
đối tượng | Bắt buộc |
Các thông số dành riêng cho nhà cung cấp ví điện tử đã chọn.
Các tham số bắt buộc là:
|