Data pesanan Shop Cash dan integrasi pihak ketiga

Saat pelanggan menggunakan Shop Cash pada pesanan, Shop Cash diperlakukan sebagai metode pembayaran. Ini bukan diskon, kartu hadiah, atau kredit toko. Sisa saldo pesanan dibayar dengan Shop Pay atau Shop Pay Installments.

Misalnya, jika pelanggan menggunakan Shop Cash sebesar $25 USD untuk pesanan $100 USD, maka pesanan tersebut mencakup pembayaran Shop Cash senilai $25 USD dan pembayaran Shop Pay senilai $75 USD. Data pesanan Anda dapat menyertakan lebih dari satu metode pembayaran untuk pesanan yang sama.

Shop Cash muncul sebagai transaksi pesanan dengan nilai gateway shop_cash saat nilai gateway tersedia. Transaksi Shop Cash mengikuti siklus hidup transaksi standar, seperti otorisasi, penagihan, pembatalan, dan pengembalian dana. Shop Cash tidak menggunakan jenis transaksi penjualan gabungan.

Jika pelanggan juga menggunakan penawaran Shop dari Shop Campaign, maka nilai yang didanai kampanye disertakan dalam jumlah transaksi pesanan shop_cash yang sama. Bagian saldo pembeli dan bagian yang didanai kampanye tidak disajikan sebagai transaksi pesanan terpisah. Mulai Januari 2026, biaya kampanye dibebankan ke tagihan Shopify Anda dan bukan dipotong dari pembayaran Anda, sehingga transaksi tagihan kampanye dalam aktivitas pembayaran hanya berlaku untuk kampanye yang berjalan sebelum tanggal tersebut. Untuk informasi lebih lanjut, rujuk ke Biaya, Shop Campaigns, dan Shop Cash.

Sistem pihak ketiga yang mengimpor pesanan, transaksi, pembayaran, pemenuhan, pengembalian dana, atau pengembalian barang perlu mengenali Shop Cash sebagai metode pembayaran. Jika suatu sistem tidak mengenali Shop Cash, maka pesanan yang menyertakan Shop Cash dapat gagal diimpor, diimpor dengan data pembayaran yang tidak lengkap, atau memerlukan pemetaan manual.

Tinjau persyaratan berikut dengan penyedia sistem pihak ketiga Anda:

• Sistem dapat mendukung lebih dari satu metode pembayaran pada satu pesanan.
• Sistem dapat memetakan shop_cash sebagai metode pembayaran.
• Sistem tidak memperlakukan Shop Cash sebagai diskon, kartu hadiah, atau kredit toko.
• Sistem menyimpan ID transaksi pesanan untuk setiap otorisasi, penagihan, pembatalan, dan pengembalian dana Shop Cash.
• Sistem menyimpan nilai otorisasi Shop Cash selengkapnya tanpa memotongnya, jika nilai tersebut disertakan dalam data yang diimpor sistem.
• Sistem memperlakukan nilai otorisasi sebagai string buram (opaque) dan tidak mengurai, mendekode, menormalkan, melakukan hash, atau menyimpulkan arti dari nilai tersebut.
• Sistem dapat memproses pengembalian dana yang mengembalikan dana ke Shop Pay maupun Shop Cash.
• Sistem dapat merekonsiliasi transaksi pembayaran Shop Cash secara terpisah dari transaksi pembayaran kartu.
• Sistem tidak mengasumsikan bahwa transaksi dikembalikan dalam urutan tertentu.

Jika sistem pihak ketiga Anda berasumsi bahwa setiap pesanan hanya memiliki satu metode pembayaran, hubungi penyedia sistem sebelum memproses pesanan Shop Cash melalui sistem tersebut.

Nilai otorisasi pada transaksi Shop Cash adalah string buram yang panjangnya bervariasi. Ini bukanlah kode otorisasi kartu yang pendek dan tidak dapat dibaca manusia.

Jika ERP, OMS, atau sistem pihak ketiga Anda yang lain mengimpor nilai otorisasi Shop Cash, simpan nilai penuh persis seperti yang diberikan. Gunakan kolom teks tak terikat atau yang panjangnya bervariasi jika memungkinkan.

Saat sistem Anda menyimpan nilai otorisasi Shop Cash, ikuti panduan berikut:

• Jangan memotong nilai ke panjang tetap yang pendek, misalnya 50 atau 100 karakter.
• Jangan mengurai atau menyimpulkan arti dari bagian mana pun dalam nilai tersebut.
• Jangan gunakan nilai otorisasi untuk mengidentifikasi transaksi untuk operasi API penagihan, pembatalan, atau pengembalian dana.

Nilai otorisasi yang terpotong dapat menyebabkan gagalnya impor pihak ketiga atau pemrosesan ERP dan OMS hilir.

Untuk mendukung penagihan, pembatalan, dan pengembalian dana melalui Admin API, simpan ID transaksi pesanan dan hubungan transaksi induk. Operasi penagihan dan pembatalan Admin API mengidentifikasi transaksi otorisasi dengan parentTransactionId. Operasi pengembalian dana mengidentifikasi transaksi penagihan yang dapat dikembalikan dananya dengan parentId.

Saat aplikasi atau integrasi mengeluarkan pengembalian dana Shop Cash melalui API, pengembalian dana harus menjadikan transaksi penagihan Shop Cash sebagai induknya, dan bukannya transaksi otorisasi Shop Cash. Pengembalian dana terhadap transaksi otorisasi akan ditolak.

Aplikasi pengembalian dana dan pengelola webhook harus mengidentifikasi transaksi penagihan Shop Cash yang dapat dikembalikan dananya, menghitung sisa jumlah yang dapat dikembalikan dananya untuk penagihan tersebut, dan membuat pengembalian dana terhadap ID transaksi penagihan.

Saat Anda menggunakan Admin API, ekspor pesanan, ekspor pembayaran, atau ekspor aplikasi pihak ketiga, perlakukan Shop Cash sebagai data pembayaran. Bergantung pada ekspor atau sumber daya API yang Anda gunakan, informasi Shop Cash dapat direpresentasikan melalui metode pembayaran, gateway, transaksi pesanan, transaksi pembayaran, dan data pengembalian dana.

Saat Anda membangun atau memperbarui integrasi, simpan informasi berikut untuk pesanan yang mencakup Shop Cash:

• ID pesanan dan nama pesanan.
• Nilai metode pembayaran atau gateway, seperti shop_cash jika tersedia.
• ID transaksi pesanan untuk setiap transaksi pembayaran.
• Jenis dan status transaksi, seperti otorisasi, pengambilan, pengembalian dana, atau pembatalan.
• Jumlah dan mata uang transaksi.
• Hubungan transaksi induk, jika tersedia.
• ID pembayaran, jika tersedia.
• Nilai otorisasi penuh, jika sistem Anda mengimpornya.
• ID pembayaran dan ID transaksi saldo saat Anda merekonsiliasi pembayaran.
• ID transaksi pengembalian dana saat Anda merekonsiliasi pengembalian.

Untuk detail tentang kolom Admin API yang tersedia, lihat developer documentation transaksi pesanan Admin API. Hindari mengandalkan kolom yang tidak lagi didukung seperti OrderTransaction.authorizationCode untuk integrasi baru.

Contoh sederhana berikut menunjukkan pesanan senilai USD 100 yang dibayar sebesar USD 75 melalui Shopify Payments dan USD 25 melalui Shop Cash. Nilai-nilai ini hanya sebagai ilustrasi.

{
  "transactions": [
    {
      "kind": "authorization",
      "gateway": "shopify_payments",
      "status": "success",
      "amount": "75.00",
      "currency": "USD",
      "parent_id": null,
      "authorization": "ch_3OabcXYZ..."
    },
    {
      "kind": "authorization",
      "gateway": "shop_cash",
      "status": "success",
      "amount": "25.00",
      "currency": "USD",
      "parent_id": null,
      "authorization": "<long-opaque-variable-length-string>"
    },
    {
      "kind": "capture",
      "gateway": "shop_cash",
      "status": "success",
      "amount": "25.00",
      "currency": "USD",
      "parent_id": "<shop-cash-authorization-transaction-id>",
      "authorization": null
    }
  ]
}

Shop Cash mungkin terlihat mirip dengan pembayaran atau nilai promosi lainnya, tetapi sistem Anda harus memperlakukan setiap nilai secara terpisah:

Sebelum Anda mengandalkan sistem pihak ketiga untuk pesanan yang menyertakan Shop Cash, konfirmasikan persyaratan berikut:

• Shop Cash dipetakan sebagai metode pembayaran.
• Pesanan dengan Shop Cash dan Shop Pay diimpor dengan kedua metode pembayaran.
• Logika metode pembayaran tidak mengasumsikan satu metode pembayaran per pesanan.
• Nilai otorisasi disimpan sebagai string buram yang panjang dan tidak dipotong.
• Logika pengembalian dana dapat mengembalikan dana transaksi pengambilan yang benar.
• Logika pengembalian dana dapat mengembalikan dana ke metode pembayaran yang benar.
• Rekonsiliasi pembayaran dapat memperhitungkan jenis transaksi kredit, pengembalian dana, dan kampanye Shop Cash.
• Alur kerja pemenuhan, akuntansi, dan pengembalian tidak memperlakukan Shop Cash sebagai diskon.

Jika Anda menggunakan beberapa sistem, selesaikan tinjauan ini untuk setiap sistem yang menerima data pesanan, transaksi, pembayaran, pemenuhan, pengembalian dana, atau pengembalian.