ข้อมูลคำสั่งซื้อ Shop Cash และการผสานการทำงานกับระบบภายนอก

เมื่อลูกค้าใช้ Shop Cash ในคำสั่งซื้อ ระบบจะถือว่า Shop Cash เป็นวิธีการชำระเงิน ซึ่งไม่ใช่ส่วนลด บัตรของขวัญ หรือเครดิตร้านค้า ยอดคงเหลือของคำสั่งซื้อจะได้รับการชำระด้วย Shop Pay หรือการผ่อนชำระผ่าน Shop Pay

ตัวอย่างเช่น หากลูกค้าใช้ Shop Cash มูลค่า 25 ดอลลาร์สหรัฐในคำสั่งซื้อที่มีมูลค่า 100 ดอลลาร์สหรัฐ คำสั่งซื้อดังกล่าวจะประกอบด้วยการชำระเงินด้วย Shop Cash จำนวน 25 ดอลลาร์สหรัฐและการชำระเงินด้วย Shop Pay จำนวน 75 ดอลลาร์สหรัฐ ข้อมูลคำสั่งซื้อของคุณอาจมีวิธีการชำระเงินมากกว่าหนึ่งวิธีในคำสั่งซื้อเดียวกัน

Shop Cash จะแสดงเป็นธุรกรรมคำสั่งซื้อที่มีค่าเกตเวย์เป็น shop_cash ในตำแหน่งที่มีค่าเกตเวย์ ธุรกรรม Shop Cash จะเป็นไปตามวงจรของธุรกรรมมาตรฐาน เช่น การให้อนุญาต การรับเงิน การยกเลิก และการคืนเงิน Shop Cash จะไม่ใช้ประเภทธุรกรรมการขายแบบรวม

หากลูกค้าใช้ข้อเสนอของ Shop จาก Shop Campaigns ด้วย มูลค่าที่สนับสนุนโดยแคมเปญจะรวมอยู่ในยอดธุรกรรมคำสั่งซื้อ shop_cash เดียวกัน ส่วนที่มาจากยอดคงเหลือของผู้ซื้อและส่วนที่ได้รับการสนับสนุนจากแคมเปญจะไม่แสดงแยกกันในธุรกรรมคำสั่งซื้อ ตั้งแต่เดือนมกราคม 2026 เป็นต้นไป ค่าใช้จ่ายของแคมเปญจะถูกเรียกเก็บในใบเรียกเก็บเงินของ Shopify แทนที่จะหักจากยอดเงินเข้าของคุณ ดังนั้นธุรกรรมการเรียกเก็บเงินของแคมเปญในกิจกรรมยอดเงินเข้าจะใช้ได้กับแคมเปญที่ดำเนินการก่อนวันที่ดังกล่าวเท่านั้น หากต้องการข้อมูลเพิ่มเติม โปรดดูที่ ค่าธรรมเนียม Shop Campaigns และ Shop Cash

ระบบภายนอกที่นำเข้าคำสั่งซื้อ ธุรกรรม การชำระเงิน การจัดการคำสั่งซื้อ การคืนเงิน หรือการคืนสินค้าจะต้องจดจำ Shop Cash ในฐานะวิธีการชำระเงิน หากระบบไม่รู้จัก Shop Cash คำสั่งซื้อที่มี Shop Cash อาจนำเข้าไม่สำเร็จ มีข้อมูลการชำระเงินไม่ครบถ้วน หรือต้องดำเนินการแมปข้อมูลด้วยตนเอง

โปรดตรวจสอบข้อกำหนดต่อไปนี้ร่วมกับผู้ให้บริการระบบภายนอกของคุณ

• ระบบสามารถรองรับวิธีการชำระเงินมากกว่าหนึ่งวิธีในหนึ่งคำสั่งซื้อ
• ระบบสามารถแมป shop_cash เป็นวิธีการชำระเงินได้
• ระบบไม่ถือว่า Shop Cash เป็นส่วนลด บัตรของขวัญ หรือเครดิตร้านค้า
• ระบบจะจัดเก็บ ID ธุรกรรมคำสั่งซื้อสำหรับแต่ละการให้อนุญาต การรับเงิน การยกเลิก และการคืนเงินของ Shop Cash
• ระบบจะจัดเก็บค่าการให้อนุญาต Shop Cash แบบเต็มโดยไม่มีการตัดทอน หากค่านั้นรวมอยู่ในข้อมูลที่ระบบนำเข้า
• ระบบถือว่าค่าการให้อนุญาตเป็นสตริงที่ไม่มีโครงสร้างชัดเจนและไม่ทำการแยกแยะ ถอดรหัส ทำให้เป็นมาตรฐาน แฮช หรือตีความหมายจากค่าดังกล่าว
• ระบบสามารถประมวลผลการคืนเงินที่จะคืนไปยัง Shop Pay และ Shop Cash ได้
• ระบบสามารถกระทบยอดธุรกรรมยอดเงินเข้าของ Shop Cash แยกจากธุรกรรมการชำระเงินด้วยบัตรได้
• ระบบไม่ได้สันนิษฐานว่าธุรกรรมต่างๆ จะถูกส่งคืนตามลำดับเฉพาะเจาะจง

หากระบบภายนอกของคุณตั้งสมมติฐานว่าแต่ละคำสั่งซื้อมีวิธีการชำระเงินเพียงวิธีเดียว โปรดติดต่อผู้ให้บริการก่อนประมวลผลคำสั่งซื้อของ Shop Cash ผ่านระบบดังกล่าว

ค่าการให้อนุญาตในธุรกรรม Shop Cash เป็นสตริงที่ไม่มีโครงสร้างชัดเจนและมีความยาวไม่แน่นอน ซึ่งไม่ใช่รหัสการให้อนุญาตของบัตรแบบสั้นและไม่สามารถอ่านออกได้ด้วยตาเปล่า

หากระบบ ERP OMS หรือระบบภายนอกอื่นๆ นำเข้าค่าการให้อนุญาต Shop Cash โปรดจัดเก็บค่าแบบเต็มตามที่ระบุไว้ให้ครบถ้วน หากเป็นไปได้ให้ใช้ช่องข้อความแบบที่มีความยาวไม่แน่นอนหรือไม่จำกัดความยาว

เมื่อระบบของคุณจัดเก็บค่าการให้อนุญาต Shop Cash โปรดปฏิบัติตามคำแนะนำต่อไปนี้

• อย่าตัดทอนค่าให้มีความยาวตายตัวที่สั้นลง เช่น 50 หรือ 100 ตัวอักษร
• อย่าแยกแยะหรือตีความหมายจากส่วนใดส่วนหนึ่งของค่าดังกล่าว
• อย่าใช้ค่าการให้อนุญาตในการระบุธุรกรรมสำหรับดำเนินการผ่าน API เพื่อรับเงิน ยกเลิก หรือคืนเงิน

ค่าการให้อนุญาตที่ถูกตัดทอนอาจทำให้การนำเข้าจากระบบภายนอกหรือการประมวลผลต่อของ ERP และ OMS ล้มเหลว

เพื่อรองรับการรับเงิน การยกเลิก และการคืนเงินผ่าน Admin API โปรดจัดเก็บ ID ธุรกรรมคำสั่งซื้อและความสัมพันธ์ของธุรกรรมหลัก การดำเนินการรับเงินและการยกเลิกของ Admin API จะระบุธุรกรรมการให้อนุญาตด้วย parentTransactionId ส่วนการดำเนินการคืนเงินจะระบุธุรกรรมการรับเงินที่สามารถคืนเงินได้ด้วย parentId

เมื่อแอปหรือการผสานการทำงานดำเนินการคืนเงิน Shop Cash ผ่าน API การคืนเงินจะต้องเชื่อมโยงกับธุรกรรมการรับเงินของ Shop Cash เป็นหลัก ไม่ใช่ธุรกรรมการให้อนุญาตของ Shop Cash การคืนเงินที่ดำเนินการกับธุรกรรมการให้อนุญาตจะถูกปฏิเสธ

แอปคืนเงินและตัวจัดการ Webhook ควรระบุธุรกรรมการรับเงินของ Shop Cash ที่สามารถคืนเงินได้ คำนวณยอดคงเหลือที่สามารถคืนเงินได้สำหรับการรับเงินนั้น และสร้างการคืนเงินโดยอ้างอิงจาก ID ธุรกรรมการรับเงิน

เมื่อคุณใช้ Admin API การส่งออกคำสั่งซื้อ การส่งออกยอดเงินเข้า หรือการส่งออกแอปจากภายนอก ให้ถือว่า Shop Cash เป็นข้อมูลการชำระเงิน ข้อมูล Shop Cash อาจแสดงผ่านวิธีการชำระเงิน เกตเวย์ ธุรกรรมคำสั่งซื้อ ธุรกรรมยอดเงินเข้า และข้อมูลการคืนเงิน ทั้งนี้ขึ้นอยู่กับการส่งออกหรือทรัพยากร API ที่คุณใช้

เมื่อคุณสร้างหรืออัปเดตการผสานการทำงาน โปรดจัดเก็บข้อมูลสำหรับคำสั่งซื้อที่มี Shop Cash ดังนี้

• ID คำสั่งซื้อและชื่อคำสั่งซื้อ
• วิธีการชำระเงินหรือค่าเกตเวย์ เช่น shop_cash หากมี
• ID ธุรกรรมคำสั่งซื้อสำหรับแต่ละธุรกรรมการชำระเงิน
• ประเภทและสถานะธุรกรรม เช่น การอนุมัติ การตัดบัญชี การคืนเงิน หรือการยกเลิก
• จำนวนเงินและสกุลเงินของธุรกรรม
• ความสัมพันธ์ของธุรกรรมหลัก หากมี
• ID การชำระเงิน หากมี
• มูลค่าการอนุมัติเต็มจำนวน หากระบบของคุณนำเข้าข้อมูลดังกล่าว
• ID ยอดเงินเข้าและ ID ธุรกรรมยอดคงเหลือเมื่อคุณกระทบยอดเงินเข้า
• ID ธุรกรรมการคืนเงินเมื่อคุณกระทบยอดการคืนสินค้า

สำหรับรายละเอียดเกี่ยวกับช่อง Admin API ที่มี โปรดดูที่ Dev Docs ของธุรกรรมคำสั่งซื้อใน Admin API หลีกเลี่ยงการอิงตามช่องที่เลิกใช้แล้ว เช่น OrderTransaction.authorizationCode สำหรับการผสานการทำงานใหม่

ตัวอย่างแบบง่ายต่อไปนี้แสดงคำสั่งซื้อมูลค่า 100 ดอลลาร์สหรัฐที่ชำระเงินผ่าน Shopify Payments จำนวน 75 ดอลลาร์สหรัฐและผ่าน Shop Cash จำนวน 25 ดอลลาร์สหรัฐ มูลค่านี้เป็นเพียงภาพประกอบเท่านั้น

{
  "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 อาจดูคล้ายกับมูลค่าการชำระเงินหรือโปรโมชันอื่นๆ แต่ระบบของคุณควรจัดการแต่ละมูลค่าแยกกันดังนี้

ก่อนที่คุณจะใช้ระบบจากภายนอกสำหรับคำสั่งซื้อที่มี Shop Cash โปรดยืนยันข้อกำหนดดังต่อไปนี้

• มีการจับคู่ Shop Cash เป็นวิธีการชำระเงิน
• ระบบนำเข้าคำสั่งซื้อด้วย Shop Cash และ Shop Pay พร้อมวิธีการชำระเงินทั้งสองแบบ
• ตรรกะวิธีการชำระเงินไม่ได้กำหนดให้ใช้วิธีการชำระเงินเดียวต่อคำสั่งซื้อ
• มูลค่าการอนุมัติจะจัดเก็บเป็นสตริงแบบทึบขนาดยาวและไม่ถูกตัดทอน
• ตรรกะการคืนเงินสามารถคืนเงินตามธุรกรรมการตัดบัญชีที่ถูกต้องได้
• ตรรกะการคืนเงินสามารถคืนเงินไปยังวิธีการชำระเงินที่ถูกต้องได้
• การกระทบยอดเงินเข้าสามารถจัดการประเภทธุรกรรมของเครดิต Shop Cash การคืนเงิน และแคมเปญได้
• เวิร์กโฟลว์การจัดการคำสั่งซื้อ การบัญชี และการคืนสินค้าจะไม่ถือว่า Shop Cash เป็นส่วนลด

หากคุณใช้หลายระบบ ให้ตรวจสอบระบบแต่ละรายการที่รับข้อมูลคำสั่งซื้อ ธุรกรรม ยอดเงินเข้า การจัดการคำสั่งซื้อ การคืนเงิน หรือการคืนสินค้าให้เสร็จสมบูรณ์