Cấu hình trình xử lý thanh toán Google Pay

Tài liệu tham khảo này dựa trên config object schema (sơ đồ đối tượng cấu hình) 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,
        "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": {
          ...
        }
      }
    }
  ]
}

Thuộc tính

Thuộc tính Loại 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.
  • TEST: Thông tin thanh toán chỉ dùng cho mục đích kiểm thử.
  • PRODUCTION: Thông tin đăng nhập thanh toán thực, có thể uỷ quyền.
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 Google Pay & Wallet Console. Đây là thông tin bắt buộc đối với môi trường PRODUCTION. Đây là thông tin 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ợ. Chỉ hỗ trợ CARD.
allowed_payment_methods[].parameters đối tượ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.
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ẻ.
  • PAN_ONLY: Trả về số tài khoản chính (PAN) và ngày hết hạn của thẻ trong Google Wallet.
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.assurance_details_required boolean Không bắt buộc Đặt thành true để yêu cầu thông tin đảm bảo thẻ.
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.
  • MIN: Tên, mã quốc gia và mã ZIP/mã bưu chính (mặc định).
  • FULL: Tên, địa chỉ đường phố, địa phương, khu vực, mã quốc gia và mã bưu chính.
  • FULL-ISO3166: Tên, địa chỉ đường phố, địa phương, khu vực, mã quốc gia, mã bưu chính và iso3166AdministrativeArea.
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 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.
allowed_payment_methods[].tokenization_specification.type chuỗi Bắt buộc Loại mã hoá.
  • PAYMENT_GATEWAY: Được dùng nếu bạn xử lý các khoản thanh toán thông qua một [cổng được hỗ trợ](/pay/api#participating-processors). Trả về một tải trọng được mã hoá để chuyển đến PSP của bạn.
  • DIRECT: Được dùng nếu bạn tự giải mã thông tin đăng nhập (yêu cầu tuân thủ PCI DSS Cấp 1).
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à: Đối với DIRECT, các tham số bắt buộc là:
  • protocolVersion: Phiên bản của giao thức mã hoá và chữ ký dự kiến trong thông tin đăng nhập Google Pay. Chỉ hỗ trợ ECv2. Hãy xem phần Mã hoá dữ liệu thanh toán để biết thêm thông tin.
  • publicKey: Khoá công khai đường cong elip được mã hoá dạng Base64. Hãy xem phần Định dạng khoá công khai mã hoá để biết thêm thông tin.