Data pesanan Shop Cash dan penyepaduan pihak ketiga

Apabila pelanggan menggunakan Shop Cash pada pesanan, Shop Cash dianggap sebagai kaedah pembayaran. Shop Cash bukanlah diskaun, kad hadiah atau kredit kedai. Apa-apa baki pesanan yang tinggal dibayar dengan Shop Pay atau Ansuran Shop Pay.

Sebagai contoh, jika pelanggan menggunakan $25 USD dalam Shop Cash pada pesanan $100 USD, maka pesanan itu menyertakan pembayaran Shop Cash sebanyak $25 USD dan pembayaran Shop Pay sebanyak $75 USD. Data pesanan anda boleh menyertakan lebih daripada satu kaedah pembayaran untuk pesanan yang sama.

Shop Cash kelihatan sebagai transaksi pesanan dengan nilai get laluan shop_cash di tempat nilai get laluan tersedia. Transaksi Shop Cash mengikut kitaran hayat transaksi standard, seperti kebenaran, penangkapan, tindakan terbatal dan bayaran balik. Shop Cash tidak menggunakan jenis transaksi jualan gabungan.

Jika pelanggan juga menggunakan tawaran Shop daripada Shop Campaign, maka nilai yang dibiayai oleh kempen disertakan dalam amaun transaksi pesanan shop_cash yang sama. Bahagian baki pembeli dan pembiayaan kempen tidak diwakili sebagai transaksi pesanan yang berasingan. Setakat Januari 2026, kos kempen dicaj kepada bil Shopify anda, bukannya ditolak daripada pembayaran anda, jadi transaksi pengebilan kempen dalam aktiviti pembayaran hanya terpakai untuk kempen yang dijalankan sebelum tarikh tersebut. Untuk mendapatkan maklumat lanjut, rujuk Yuran, Shop Campaigns dan Shop Cash.

Sistem pihak ketiga yang mengimport pesanan, transaksi, pembayaran, pemenuhan, bayaran balik atau pemulangan perlu mengenali Shop Cash sebagai kaedah pembayaran. Jika sistem tidak mengenali Shop Cash, maka pesanan yang menyertakan Shop Cash boleh gagal untuk diimport, diimport dengan data pembayaran yang tidak lengkap atau memerlukan pemetaan manual.

Semak keperluan berikut dengan penyedia sistem pihak ketiga anda:

• Sistem boleh menyokong lebih daripada satu kaedah pembayaran pada satu pesanan.
• Sistem boleh memetakan shop_cash sebagai kaedah pembayaran.
• Sistem tidak menganggap Shop Cash sebagai diskaun, kad hadiah atau kredit kedai.
• Sistem menyimpan ID transaksi pesanan untuk setiap kebenaran, penangkapan, tindakan terbatal dan bayaran balik Shop Cash.
• Sistem menyimpan nilai kebenaran Shop Cash penuh tanpa memotongnya, jika nilai itu disertakan dalam data yang diimport oleh sistem.
• Sistem menganggap nilai kebenaran sebagai rentetan legap dan tidak menghuraikan, menyahkodkan, menormalkan, mencincang atau membuat inferens makna daripadanya.
• Sistem boleh memproses bayaran balik yang mengembalikan dana kepada kedua-dua Shop Pay dan Shop Cash.
• Sistem boleh menyesuaikan transaksi pembayaran Shop Cash secara berasingan daripada transaksi pembayaran kad.
• Sistem tidak menganggap bahawa transaksi dipulangkan mengikut urutan yang khusus.

Jika sistem pihak ketiga anda menganggap bahawa setiap pesanan hanya mempunyai satu kaedah pembayaran, maka hubungi penyedia sebelum memproses pesanan Shop Cash melalui sistem tersebut.

Nilai kebenaran pada transaksi Shop Cash ialah rentetan legap yang panjangnya boleh ubah. Nilai ini bukan kod kebenaran kad yang pendek dan tidak boleh dibaca oleh manusia.

Jika ERP, OMS atau sistem pihak ketiga anda yang lain mengimport nilai kebenaran Shop Cash, simpan nilai penuh tepat seperti yang disediakan. Gunakan medan teks dengan panjang boleh ubah atau tidak terikat sekiranya boleh.

Apabila sistem anda menyimpan nilai kebenaran Shop Cash, ikuti garis panduan ini:

• Jangan potong nilai kepada panjang tetap yang pendek, seperti 50 atau 100 aksara.
• Jangan huraikan atau buat inferens makna daripada mana-mana bahagian nilai.
• Jangan gunakan nilai kebenaran untuk mengenal pasti transaksi bagi operasi API penangkapan, tindakan terbatal atau bayaran balik.

Nilai kebenaran yang dipotong boleh menyebabkan import pihak ketiga atau pemprosesan ERP dan OMS hiliran gagal.

Untuk menyokong penangkapan, tindakan terbatal dan bayaran balik melalui Admin API, simpan ID transaksi pesanan dan hubungan transaksi induk. Operasi penangkapan dan terbatal Admin API mengenal pasti transaksi kebenaran dengan parentTransactionId. Operasi bayaran balik mengenal pasti transaksi penangkapan yang boleh dikembalikan bayarannya dengan parentId.

Apabila aplikasi atau penyepaduan mengeluarkan bayaran balik Shop Cash melalui API, bayaran balik mesti menetapkan transaksi penangkapan Shop Cash sebagai induk, bukan transaksi kebenaran Shop Cash. Bayaran balik terhadap transaksi kebenaran akan ditolak.

Aplikasi bayaran balik dan pengendali webhook harus mengenal pasti transaksi penangkapan Shop Cash yang boleh dikembalikan bayarannya, mengira baki amaun yang boleh dikembalikan bayarannya untuk penangkapan tersebut dan mencipta bayaran balik berdasarkan ID transaksi penangkapan.

Apabila anda menggunakan Admin API, eksport pesanan, eksport pembayaran atau eksport aplikasi pihak ketiga, anggap Shop Cash sebagai data pembayaran. Bergantung pada eksport atau sumber API yang anda gunakan, maklumat Shop Cash boleh diwakili melalui kaedah pembayaran, get laluan, transaksi pesanan, transaksi pembayaran dan data bayaran balik.

Apabila anda membina atau mengemas kini integrasi, simpan maklumat berikut untuk pesanan yang termasuk Shop Cash:

• ID pesanan dan nama pesanan.
• Kaedah pembayaran atau nilai get laluan, seperti shop_cash apabila tersedia.
• ID transaksi pesanan untuk setiap transaksi pembayaran.
• Jenis dan status transaksi, seperti kebenaran, tangkapan, bayaran balik atau terbatal.
• Amaun dan mata wang transaksi.
• Hubungan transaksi induk, apabila tersedia.
• ID pembayaran, apabila tersedia.
• Nilai kebenaran penuh, jika sistem anda mengimportnya.
• ID pembayaran dan ID transaksi baki apabila anda menyesuaikan pembayaran.
• ID transaksi bayaran balik apabila anda menyesuaikan pemulangan.

Untuk butiran mengenai medan Admin API yang tersedia, rujuk kepada dokumentasi pembangun transaksi pesanan Admin API. Elakkan bergantung pada medan yang ditamatkan penggunaannya seperti OrderTransaction.authorizationCode untuk integrasi baharu.

Contoh yang diringkaskan berikut menunjukkan pesanan USD100 yang dibayar dengan USD75 melalui Shopify Payments dan USD25 melalui Shop Cash. Nilai adalah untuk ilustrasi sahaja.

{
  "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 kelihatan serupa dengan nilai pembayaran atau promosi yang lain, tetapi sistem anda harus menganggap setiap nilai secara berasingan:

Sebelum anda bergantung pada sistem pihak ketiga untuk pesanan yang termasuk Shop Cash, sahkan keperluan berikut:

• Shop Cash dipetakan sebagai kaedah pembayaran.
• Pesanan dengan Shop Cash dan Shop Pay diimport dengan kedua-dua kaedah pembayaran.
• Logik kaedah pembayaran tidak menganggap satu kaedah pembayaran untuk setiap pesanan.
• Nilai kebenaran disimpan sebagai rentetan legap yang panjang dan tidak dipotong.
• Logik bayaran balik boleh membayar balik transaksi tangkapan yang betul.
• Logik bayaran balik boleh memulangkan dana kepada kaedah pembayaran yang betul.
• Penyesuaian pembayaran boleh mengambil kira jenis transaksi kredit, bayaran balik dan kempen Shop Cash.
• Aliran kerja pemenuhan, perakaunan dan pemulangan tidak menganggap Shop Cash sebagai diskaun.

Jika anda menggunakan berbilang sistem, maka lengkapkan semakan ini untuk setiap sistem yang menerima data pesanan, transaksi, pembayaran, pemenuhan, bayaran balik atau pemulangan.