Menyiapkan diskon otomatis

Untuk menerapkan token harga, ikuti petunjuk berikut.

Struktur token

Token JWT berisi dua objek JSON: header dan payload.

Header

---

{

"alg": "ES256",

"typ": "JWT"

}

---

Header token yang dibuat Google memiliki 2 kolom:

• alg - algoritma yang digunakan, nilainya selalu "ES256"
• typ - jenis media, nilainya selalu "JWT"

Jika header token berisi kolom lain, atau nilai kolom berbeda dengan yang dijelaskan di atas, token harus ditolak.

Payload

---

{

"exp": 1571673600,

"o": "tddy123uk",

"m": "140301646",

"p": 21,99,

"c": "USD"

}

---

Payload memiliki kolom berikut:

• exp - waktu berakhirnya masa berlaku yang dinyatakan dalam waktu Unix. Jika masa berlaku token telah berakhir, token tersebut harus ditolak.
• o - ID penawaran, yang dapat digunakan untuk memeriksa halaman landing yang cocok dengan produk. Jika terdapat ketidakcocokan, token harus ditolak.
• m - ID Merchant. Jika ID Merchant tidak cocok, token harus ditolak.
• p - harga diskon
• c - mata uang, huruf besar

Pemakaian token

Detail persis tentang pemakaian token bergantung pada library yang digunakan, tetapi di tingkat atas, ada 3 langkah: dekode dan validasi tanda tangan, validasi kolom, serta pemakaian harga.

Dekode dan validasi tanda tangan Token dengan enkode Base64URL diteruskan dalam parameter permintaan URL pv2:

Sebagian besar library menggabungkan validasi tanda tangan dan decoding menjadi fungsi tunggal dengan 'token", "ES256" (algoritme), dan "kunci publik" sebagai input, dan "token_body" sebagai output:

Kunci publik untuk validasi:

Kunci berikut ditujukan untuk digunakan oleh semua pengguna diskon otomatis tanpa batas masa berlaku.

Validasi kolom

Jika library yang dipilih menerima kunci dan algoritme di langkah sebelumnya, lalu memaksa penggunaannya meskipun ada opsi header, pemeriksaan header tambahan tidak perlu dilakukan. Jika tidak, kolom header harus diperiksa sesuai dengan panduan di atas. Untuk informasi selengkapnya, tinjau JSON Web Token Best Current Practices.

Apa pun library yang digunakan, kolom o, m, dan p harus divalidasi terhadap data dari pihak penjual. Jika tidak cocok, token harus ditolak agar pelanggan tidak dapat menyalin token ke produk dan/atau penjual lain. Penjual dapat memeriksa kolom exp dan menolak token jika masa berlaku token sudah berakhir, tetapi tindakan ini tidak wajib.

Pemakaian harga Jika semua kolom sudah valid dan masa berlaku token belum berakhir, penjual harus menggunakan harga yang tercantum di kolom p.

Anda dapat menggunakan fungsi kupon yang ada untuk memberi diskon pada harga jika memenuhi persyaratan yang tercantum di halaman ini. Khususnya, harga di halaman landing harus sesuai dengan harga di token. Menambahkan diskon di halaman checkout saja tidak cukup.

Pengujian Integrasi yang telah diselesaikan akan diuji dalam 3 langkah:

• Pengujian fungsional (dilakukan oleh penjual)
• Validasi kunci (dilakukan oleh penjual dengan token yang disediakan Google)
• Pengujian lengkap yang menyeluruh (dilakukan oleh Google)

Pengujian fungsional Cara termudah untuk melakukan pengujian selama dan setelah pengembangan adalah dengan membuat pasangan kunci sementara. Tindakan ini memberi Anda kontrol penuh atas token tersebut. Pasangan kunci yang valid dapat dibuat dengan perintah ini:

Token dapat dibuat dengan jwt.io atau alat serupa menggunakan algoritma ES256.

Validasi kunci Untuk memvalidasi bahwa kunci produksi dikonfigurasi dengan benar, token bertanda tangan tersedia di Merchant Center selama aktivasi (URL contoh).