การกำหนดค่าเครื่องจัดการการชำระเงินของ Google Pay

ข้อมูลอ้างอิงนี้อิงตามสคีมา ออบเจ็กต์การกำหนดค่าสำหรับ ตัวจัดการการชำระเงินของ Google Pay สำหรับ Universal Commerce Protocol (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": {
          ...
        }
      }
    }
  ]
}

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้ ประเภท ความจำเป็น คำอธิบาย
api_version จำนวนเต็ม ต้องระบุ เวอร์ชันหลักของ Google Pay API รองรับเฉพาะ 2
api_version_minor จำนวนเต็ม ต้องระบุ เวอร์ชันย่อยของ Google Pay API รองรับเฉพาะ 0
environment สตริง ต้องระบุ สภาพแวดล้อมของ Google Pay ที่จะใช้
  • TEST: ข้อมูลเข้าสู่ระบบการชำระเงินสำหรับการทดสอบเท่านั้น
  • PRODUCTION: ข้อมูลเข้าสู่ระบบการชำระเงินจริงที่ได้รับอนุญาต
merchant_info ออบเจ็กต์ ต้องระบุ รายละเอียดข้อมูลประจำตัวของผู้ขาย
merchant_info.merchant_id สตริง ต้องระบุ รหัสผู้ขาย Google Pay จาก Google Pay & Wallet Console ต้องระบุสำหรับสภาพแวดล้อม PRODUCTION ไม่บังคับและระบบจะข้ามในสภาพแวดล้อม TEST
merchant_info.merchant_name สตริง ไม่บังคับ ชื่อธุรกิจที่ผู้ใช้เห็นของผู้ขาย
merchant_info.merchant_origin สตริง ไม่บังคับ โดเมนเว็บที่สมบูรณ์ในตัวเองซึ่งการชำระเงินเกิดขึ้น (รูปแบบ: hostname)
merchant_info.auth_jwt สตริง ไม่บังคับ JWT การให้สิทธิ์สำหรับบริบทการผสานรวมบางอย่าง
allowed_payment_methods ออบเจ็กต์[ ] ต้องระบุ วิธีการชำระเงินที่อนุญาตสำหรับธุรกรรมนี้
allowed_payment_methods[].type สตริง ต้องระบุ ประเภทวิธีการชำระเงินที่รองรับ รองรับเฉพาะ CARD
allowed_payment_methods[].parameters ออบเจ็กต์ ต้องระบุ พารามิเตอร์ที่จำเป็นในการกำหนดค่าวิธีการชำระเงิน CARD
allowed_payment_methods[].parameters.allowed_auth_methods สตริง[ ] ต้องระบุ ช่องที่รองรับในการตรวจสอบสิทธิ์ธุรกรรมด้วยบัตร
  • PAN_ONLY: แสดงหมายเลขบัญชีหลัก (PAN) และวันที่หมดอายุของบัตรที่บันทึกไว้ใน Google Wallet
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 สตริง ไม่บังคับ รูปแบบที่อยู่สำหรับการเรียกเก็บเงินที่ต้องใช้เพื่อทำธุรกรรมให้เสร็จสมบูรณ์
  • MIN: ชื่อ รหัสประเทศ และรหัสไปรษณีย์ (ค่าเริ่มต้น)
  • FULL: ชื่อ ที่อยู่ เมือง ภูมิภาค รหัสประเทศ และรหัสไปรษณีย์
  • FULL-ISO3166: ชื่อ ที่อยู่ เมือง ภูมิภาค รหัสประเทศ รหัสไปรษณีย์ และ iso3166AdministrativeArea
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required บูลีน ไม่บังคับ ตั้งค่าเป็น true หากคุณต้องใช้หมายเลขโทรศัพท์เพื่อทำธุรกรรมให้เสร็จสมบูรณ์
allowed_payment_methods[].tokenization_specification ออบเจ็กต์ ต้องระบุ การกำหนดค่าที่กำหนดวิธีส่งข้อมูลเข้าสู่ระบบการชำระเงินกลับให้คุณ
allowed_payment_methods[].tokenization_specification.type สตริง ต้องระบุ ประเภทการเข้ารหัส
  • PAYMENT_GATEWAY: ใช้หากคุณประมวลผลการชำระเงินผ่าน [เกตเวย์ที่รองรับ](/pay/api#participating-processors) แสดงเพย์โหลดที่เข้ารหัสเพื่อส่งไปยัง PSP ของคุณ
  • DIRECT: ใช้หากคุณถอดรหัสข้อมูลเข้าสู่ระบบด้วยตนเอง (ต้องเป็นไปตามข้อกำหนด PCI DSS ระดับ 1)
allowed_payment_methods[].tokenization_specification.parameters ออบเจ็กต์ ต้องระบุ พารามิเตอร์เฉพาะสำหรับ type การเข้ารหัสที่เลือก

สำหรับ PAYMENT_GATEWAY พารามิเตอร์ที่ต้องระบุ ได้แก่ สำหรับ DIRECT พารามิเตอร์ที่ต้องระบุ ได้แก่