Menyiapkan pembayaran sandbox

Mengurutkan project Menyeluruh memungkinkan konfigurasi Mode Pembayaran Sandbox saat menggunakan lingkungan Pengujian Cepat atau Sandbox. Saat menguji data feed, Anda dapat beralih antara Mode Pembayaran Sandbox dan Produksi. Guna menguji pembayaran untuk project Pemesanan End-to-End tanpa menagih kartu, gunakan Sandbox sebagai Mode Pembayaran Anda. Lingkungan produksi tidak mendukung Mode Pembayaran Sandbox.

Catatan: Saat Anda mengaktifkan Mode Pembayaran Sandbox, token instrumen berisi detail kartu pengujian yang tidak dapat ditagih. Saat menggunakan Mode Pembayaran Produksi di lingkungan Sandbox atau Pengujian Cepat, token dapat digunakan untuk menagih pembayaran.

Konfigurasi

Untuk mengaktifkan Mode Pembayaran Sandbox di lingkungan Sandbox, ikuti langkah-langkah berikut:

1. Di Actions Center, buka Configuration > Features.
2. Di kartu Fitur akun, temukan tombol pilihan Mode Pembayaran.
3. Pilih opsi Sandbox, lalu klik Save changes.

Untuk mengaktifkan Mode Pembayaran Sandbox di lingkungan Pengujian Cepat, ikuti langkah-langkah berikut:

1. Di Actions Center, buka Feeds > Quick Test.
2. Pilih tombol pilihan Gunakan sandbox untuk GPay.

Saat Mode Pembayaran Sandbox dipilih:

• Pengurutan Menyeluruh mengonfigurasi Google Pay untuk menampilkan token instrumen yang berisi data kartu pengujian, bukan detail kartu yang sebenarnya.
• Kolom isInSandbox ditetapkan ke true di CheckoutRequestMessage dan SubmitOrderRequestMessage.

Berbagai kombinasi Lingkungan, Mode Pembayaran, dan isInSandbox adalah sebagai berikut:

Environment	Mode Pembayaran	isInSandbox
Pengujian Cepat	Sandbox	true
Pengujian Cepat	Produksi	false
Sandbox	Sandbox	true
Sandbox	Produksi	false
Produksi	Produksi	false

Pesan Respons Checkout

CheckoutResponseMessage yang dikirim oleh layanan web Pemesanan Makanan Anda berisi PaymentOptions. Saat menyiapkan checkout, Anda memberikan opsi pembayaran placeholder menggunakan contoh gateway pembayaran.

• Pastikan untuk memperbarui CheckoutResponseMessage yang dikirim oleh layanan web Anda dengan konfigurasi tokenisasi yang sesuai.

Catatan: Konfigurasi tokenisasi bervariasi berdasarkan gateway pembayaran yang dipilih. Contoh parameter tokenisasi untuk setiap gateway yang disediakan tersedia di Referensi Google Pay API

Contoh opsi pembayaran

Berikut adalah contoh objek PaymentOptions JSON dari CheckoutResponseMessage untuk berbagai gateway pembayaran yang menggunakan kunci sandbox:

JSON

"paymentOptions": {
    "googleProvidedOptions": {
        "facilitationSpecification": "{\"apiVersion\":2,\"apiVersionMinor\":0,\"merchantInfo\":{\"merchantName\":\"merchantName\"},\"allowedPaymentMethods\":[{\"type\":\"CARD\",\"parameters\":{\"allowedAuthMethods\":[\"PAN_ONLY\"],\"allowedCardNetworks\":[\"VISA\",\"MASTERCARD\"],\"billingAddressRequired\":true,\"cvcRequired\":false},\"tokenizationSpecification\":{\"type\":\"PAYMENT_GATEWAY\",\"parameters\":{\"gatewayMerchantId\":\"YOUR_MERCHANT_ID\",\"gateway\":\"cybersource\"}}}],\"transactionInfo\":{\"currencyCode\":\"USD\",\"totalPriceStatus\":\"ESTIMATED\",\"totalPrice\":\"31.85\"}} "
    }
}

JSON

"paymentOptions": {
    "googleProvidedOptions": {
        "facilitationSpecification": "{\"apiVersion\":2,\"apiVersionMinor\":0,\"merchantInfo\":{\"merchantName\":\"merchantName\"},\"allowedPaymentMethods\":[{\"type\":\"CARD\",\"parameters\":{\"allowedAuthMethods\":[\"PAN_ONLY\"],\"allowedCardNetworks\":[\"VISA\",\"MASTERCARD\"],\"billingAddressRequired\":true,\"cvcRequired\":false},\"tokenizationSpecification\":{\"type\":\"PAYMENT_GATEWAY\",\"parameters\":{\"gateway\":\"braintree\",\"braintree:apiVersion\":\"v1\",\"braintree:sdkVersion\":\"1.4.0\",\"braintree:merchantId\":\"YOUR_MERCHANT_ID\",\"braintree:clientKey\":\"YOUR_BRAINTREE_SANDVOX_OR_PRODUCTION_KEY\"}}}],\"transactionInfo\":{\"currencyCode\":\"USD\",\"totalPriceStatus\":\"ESTIMATED\",\"totalPrice\":\"31.85\"}} "
    }
}

JSON

"paymentOptions": {
    "googleProvidedOptions": {
        "facilitationSpecification": "{\"apiVersion\":2,\"apiVersionMinor\":0,\"merchantInfo\":{\"merchantName\":\"merchantName\"},\"allowedPaymentMethods\":[{\"type\":\"CARD\",\"parameters\":{\"allowedAuthMethods\":[\"PAN_ONLY\"],\"allowedCardNetworks\":[\"VISA\",\"MASTERCARD\"],\"billingAddressRequired\":true,\"cvcRequired\":false},\"tokenizationSpecification\":{\"type\":\"PAYMENT_GATEWAY\",\"parameters\":{\"gateway\":\"stripe\",\"stripe:version\":\"2018-10-31\",\"stripe:publishableKey\":\"YOUR_PRODUCTION_OR_SANDBOX_STRIPE_KEY\"}}}],\"transactionInfo\":{\"currencyCode\":\"USD\",\"totalPriceStatus\":\"ESTIMATED\",\"totalPrice\":\"31.85\"}} "
    }
}

JSON

"paymentOptions": {
    "googleProvidedOptions": {
        "facilitationSpecification": "{\"apiVersion\":2,\"apiVersionMinor\":0,\"merchantInfo\":{\"merchantName\":\"merchantName\"},\"allowedPaymentMethods\":[{\"type\":\"CARD\",\"parameters\":{\"allowedAuthMethods\":[\"PAN_ONLY\"],\"allowedCardNetworks\":[\"VISA\",\"MASTERCARD\"],\"billingAddressRequired\":true,\"cvcRequired\":false},\"tokenizationSpecification\":{\"type\":\"PAYMENT_GATEWAY\",\"parameters\":{\"gateway\":\"stripev2\",\"gatewayMerchantId\":\"YOUR_PRODUCTION_OR_SANDBOX_STRIPE_KEY\"}}}],\"transactionInfo\":{\"currencyCode\":\"USD\",\"totalPriceStatus\":\"ESTIMATED\",\"totalPrice\":\"31.85\"}} "
    }
}

Tandai transaksi sandbox

Saat Mode Pembayaran Sandbox diaktifkan, kolom isInSandbox disertakan dalam permintaan dan ditetapkan ke true untuk permintaan masuk ke endpoint layanan web Anda (CheckoutRequestMessage dan SubmitOrderRequestMessage). Lakukan hal berikut saat kolom isInSandbox ditetapkan ke true:

• Gunakan kunci sandbox, bukan kunci produksi, dalam konfigurasi token untuk gateway pembayaran Anda. Sebagian besar pemroses pembayaran menyediakan kunci API untuk sandbox dan produksi.
• Jangan picu komunikasi apa pun dengan penyedia layanan web, biasanya restoran, karena mereka tidak perlu diberi tahu tentang transaksi sandbox apa pun.

Kartu kredit pengujian tidak didukung, bahkan saat sandbox transaksi diaktifkan. Anda harus menggunakan kartu kredit asli saat melakukan transaksi. Namun, token instrumen sandbox berisi detail kartu pengujian yang tidak dapat ditagih.

Catatan: Saat Anda menggunakan kartu kredit baru dengan Google Pay, tantangan CVC dapat dipicu. Tindakan tersebut akan menempatkan transaksi yang tertunda sementara pada kartu, yang masa berlakunya akan habis dalam beberapa hari.

Memproses pembayaran

Saat pelanggan mengirimkan pesanannya, Pemesanan End-to-End mengirimkan SubmitOrderRequestMessage ke endpoint layanan web Anda. Token Google Pay disertakan sebagai string berenkode base-64 di kolom instrumentToken SubmitOrderRequestMessage. Untuk memproses pembayaran pelanggan, lakukan salah satu hal berikut, bergantung pada gateway pembayaran Anda:

Gateway pembayaran
Stripe atau Braintree	Dekode string token berenkode base-64 dan kirim data yang sesuai yang terdapat dalam payload token yang didekode ke gateway pembayaran Anda untuk memproses pembayaran.
Semua gateway pembayaran lainnya (termasuk garisv2)	Kirim string token berenkode base-64 lengkap ke API gateway pembayaran Anda untuk memproses pembayaran. Struktur token metode pembayaran Google Pay berisi kolom terenkripsi yang dapat didekripsi oleh gateway pembayaran Anda untuk memproses pembayaran.

Catatan: Sebelum mengintegrasikan parameter pembayaran ke layanan web, Anda dapat mengujinya dengan pengujian pemrosesan pembayaran Google Pay.

Contoh payload yang didekode

Contoh berikut menunjukkan payload yang didekode dan ditampilkan di kolom instrumentToken untuk berbagai gateway pembayaran:

Catatan: Payload yang diterima dari gateway pembayaran selain gateway: "garis" atau gateway: "braintree" menggunakan format seperti contoh Persegi yang ditunjukkan di bawah ini.

JSON

Contoh JSON ini mewakili token pembayaran yang didekode saat menggunakan Braintree. Ekstrak nilai kolom nonce dan kirim nilainya ke Braintree untuk memproses pembayaran.

{
  "androidPayCards": [{
    "type": "AndroidPayCard",
    "nonce": "aeeb8297-4242...",
    "description": "AndroidPay",
    "consumed": false,
    "details": {
      "cardType": "Visa",
      "lastTwo": "29"
    }
  }]
}

Jika Google Pay tidak diaktifkan di panel kontrol Braintree, kolom instrumentToken akan mendekode ke error berikut:

{
  "error": {
    "message": "Record not found"
  },
  "fieldErrors": []
}

JSON

Contoh JSON ini menunjukkan token pembayaran yang didekode saat menggunakan Stripe. Ekstrak nilai kolom id dan kirimkan ke Stripe untuk memproses pembayaran.

{
  "id": "tok_abcdefg1234...",
  "object": "token",
  "card": {
    "id": "card_abcde...",
    "object": "card",
    "address_city": null,
    "address_country": null,
    "address_line1": null,
    "address_line1_check": null,
    "address_line2": null,
    "address_state": null,
    "address_zip": null,
    "address_zip_check": null,
    "brand": "Visa",
    "country": "US",
    "cvc_check": null,
    "dynamic_last4": "1234",
    "exp_month": 1,
    "exp_year": 2019,
    "funding": "credit",
    "last4": "1234",
    "metadata": {},
    "name": null,
    "tokenization_method": "android_pay"
  },
  "client_ip": "74.125.177.36",
  "created": 1500483670,
  "livemode": false,
  "type": "card",
  "used": false
}

JSON

Contoh JSON ini mewakili token pembayaran yang didekode saat menggunakan garisv2.

  {
  "protocolVersion":"ECv2",
  "signature":"MEQCIH6Q4OwQ0jAceFEkGF0JID6sJNXxOEi4r+mA7biRxqBQAiAondqoUpU/bdsrAOpZIsrHQS9nwiiNwOrr24RyPeHA0Q\u003d\u003d",
  "intermediateSigningKey":{
    "signedKey": "{\"keyExpiration\":\"1542323393147\",\"keyValue\":\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE/1+3HBVSbdv+j7NaArdgMyoSAM43yRydzqdg1TxodSzA96Dj4Mc1EiKroxxunavVIvdxGnJeFViTzFvzFRxyCw\\u003d\\u003d\"}",
    "signatures": ["MEYCIQCO2EIi48s8VTH+ilMEpoXLFfkxAwHjfPSCVED/QDSHmQIhALLJmrUlNAY8hDQRV/y1iKZGsWpeNmIP+z+tCQHQxP0v"]
  },
  "signedMessage":"{\"tag\":\"jpGz1F1Bcoi/fCNxI9n7Qrsw7i7KHrGtTf3NrRclt+U\\u003d\",\"ephemeralPublicKey\":\"BJatyFvFPPD21l8/uLP46Ta1hsKHndf8Z+tAgk+DEPQgYTkhHy19cF3h/bXs0tWTmZtnNm+vlVrKbRU9K8+7cZs\\u003d\",\"encryptedMessage\":\"mKOoXwi8OavZ\"}"
}
  

JSON

Contoh JSON ini mewakili token pembayaran yang didekode saat menggunakan Square.

  {
    "signature": "MEYCIQCMAsWCrY2GfHM/gMAKiK3QCKJJOIkjZeTQGzcdWgvrhwIhAJ3mXwe+wmU9z+Apv1rTDsCVQBzayvWzT4ywxytrSPla",
    "protocolVersion": "ECv1",
    "signedMessage": "{\"encryptedMessage\":\"WkYz21EYxojwTqWh6A3oYXtmctu1PlqF+tNYPA4cq017nqj16Ge7kaVR7MI1XG1OrCmcMwP20u5Zb5E28XYan8UI8M4L120orvE9XU1ivZuO4Myq2O3ue8v0lY1MDx8Mnk+5mkAv1kLmzJc91gEQ2leIwrPuMDYqsQUHzTR3Jikh5/v+iWRkyQPKKxgj5c6Erdu/pkg1xV6fQJcHNdq9Jw11zl95x6eQurxw2Uy8v811azGr+noKJbw0uye72MkhmzMS5QKOzwGT9nBfO+zPLYSEewsdOcPbNZF94zk/KU9nxom/gQ+eYEMIZvOj9lO4gQqDqR6DyWyStk7MjeXQTvXWZBI1JpqvOrlTHL0Ct18RpbfOio7hAtafzb0NnqEKlsun+SSpJmvI7U6n6Cnu1JUMUGfT/Jsi6RJ3N6pRw2BubeR1925Xl3jXQnlz5io6X1YRlAcnshZyf6CjBpKES32aTf1m1IHRhZ2Jj6i/g7Y\\u003d\",\"ephemeralPublicKey\":\"BDQA0Cf//BHPcnB0R/GRrWa2g7T1QF97eOhAYy7l45M+kJnsoeL9OaUQV/KIMLvcgbmKkZIm2FQeL7ftd6S4q4c\\u003d\",\"tag\":\"DHtVyXNo+PDr7Thi/EjBBbsr2k7y1SwGIn0D9mmPTJc\\u003d\"}"
  }
    

Untuk memproses pembayaran menggunakan token, tampilkan string token yang dienkode base-64 dengan permintaan Anda ke API pembayaran Square di kolom source_id yang diawali dengan gpay:

  {
    "idempotency_key": "ID",
    "source_id": "gpay:GOOGLE_PAY_BASE64_ENCODED_TOKEN",
    "amount_money": {
        "amount": 50,
        "currency": "USD"
    },
    "location_id": "LOCATION_ID",
    "billing_address": {
        "postal_code": "11111"
    }
  }

Berikut adalah contoh Node.js yang mendekode instrumentToken berenkode base-64 dari Braintree:

Node.js

function decodeToken(instrumentToken) {
  let decodedString = new Buffer(instrumentToken, 'base64').toString('ascii')
  if (decodedString.androidPayCards) {
    return decodedString.androidPayCards[0].nonce;
  }
}