Shop Cash آرڈر کا ڈیٹا اور تھرڈ پارٹی انٹیگریشن

جب کوئی کسٹمر آرڈر پر Shop Cash استعمال کرتا ہے، تو Shop Cash کو ادائیگی کے طریقے کے طور پر لیا جاتا ہے۔ یہ کوئی رعایت، گفٹ کارڈ، یا اسٹور کریڈٹ نہیں ہے۔ آرڈر کا کوئی بھی بقایا بیلنس Shop Pay یا Shop Pay قسطیں سے ادا کیا جاتا ہے۔

مثال کے طور پر، اگر کسٹمر $100 USD کے آرڈر پر $25 USD کی مالیت کا Shop Cash استعمال کرتا ہے، تو آرڈر میں $25 USD کی Shop Cash ادائیگی اور $75 USD کی Shop Pay ادائیگی شامل ہوتی ہے۔ آپ کے آرڈر کے ڈیٹا میں ایک ہی آرڈر کے لیے ایک سے زیادہ ادائیگی کے طریقے شامل ہو سکتے ہیں۔

Shop Cash shop_cash کی گیٹ وے قدر والی آرڈر ٹرانزیکشن کے طور پر ظاہر ہوتا ہے جہاں گیٹ وے کی قدر دستیاب ہوتی ہیں۔ Shop Cash ٹرانزیکشن معیاری ٹرانزیکشن لائف سائیکل کی پیروی کرتی ہے، جیسے اجازت، کیپچر، کالعدم قرار دینا، اور رقم کی واپسی۔ Shop Cash مشترکہ فروخت کی ٹرانزیکشن قسم کا استعمال نہیں کرتا ہے۔

اگر کسٹمر Shop Campaign سے کوئی Shop آفر بھی استعمال کرتا ہے، تو مہم کے ذریعے فنڈ کردہ قدر اسی shop_cash آرڈر ٹرانزیکشن کی رقم میں شامل ہو جاتی ہے۔ خریدار کے بیلنس اور مہم کے ذریعے فنڈ کردہ حصوں کو آرڈر کی الگ الگ ٹرانزیکشن کے طور پر نہیں دکھایا جاتا ہے۔ جنوری 2026 سے، مہم کی لاگت آپ کے پے آؤٹ سے کٹوتی کے بجائے آپ کے Shopify بل سے چارج کی جاتی ہیں، لہذا پے آؤٹ ایکٹیویٹی میں مہم کی بلنگ کی ٹرانزیکشن صرف ان مہمات پر لاگو ہوتی ہیں جو اس تاریخ سے پہلے چلائی گئی تھیں۔ مزید معلومات کے لیے، فیس، Shop Campaigns، اور Shop Cash دیکھیں۔

وہ تھرڈ پارٹی سسٹم جو آرڈر، ٹرانزیکشن، ادائیگیوں، فل فلمنٹ، رقم کی واپسی، یا واپسیوں کو امپورٹ کرتے ہیں، انہیں ادائیگی کے طریقے کے طور پر Shop Cash کو تسلیم کرنے کی ضرورت ہے۔ اگر کوئی سسٹم Shop Cash کو تسلیم نہیں کرتا ہے، تو Shop Cash شامل کرنے والے آرڈر امپورٹ ہونے میں ناکام ہو سکتے ہیں، نامکمل ادائیگی کے ڈیٹا کے ساتھ امپورٹ ہو سکتے ہیں، یا انہیں مینوئل میپنگ درکار ہو سکتی ہے۔

اپنے تھرڈ پارٹی سسٹم فراہم کنندہ کے ساتھ درج ذیل تقاضوں کا جائزہ لیں:

• سسٹم ایک آرڈر پر ایک سے زیادہ ادائیگی کے طریقے کو سپورٹ کر سکتا ہے۔
• سسٹم ادائیگی کے طریقے کے طور پر shop_cash کو میپ کر سکتا ہے۔
• سسٹم Shop Cash کو رعایت، گفٹ کارڈ، یا اسٹور کریڈٹ نہیں سمجھتا ہے۔
• سسٹم ہر Shop Cash کی اجازت، کیپچر، کالعدم، اور رقم کی واپسی کے لیے آرڈر کی ٹرانزیکشن ID اسٹور کرتا ہے۔
• اگر قدر اس ڈیٹا میں شامل ہے جسے سسٹم امپورٹ کرتا ہے، تو سسٹم اسے چھوٹا کیے بغیر مکمل 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 کے ساتھ قابلِ واپسی کیپچر ٹرانزیکشن کی شناخت کرتے ہیں۔

جب کوئی ایپ یا انٹیگریشن API کے ذریعے Shop Cash کی رقم کی واپسی جاری کرتی ہے، تو رقم کی واپسی کا پیرنٹ Shop Cash کی اجازت کی ٹرانزیکشن کے بجائے Shop Cash کیپچر کی ٹرانزیکشن کو بنایا جانا چاہیے۔ اجازت کی ٹرانزیکشن کے خلاف رقم کی واپسی کو مسترد کر دیا جاتا ہے۔

رقم کی واپسی کی ایپ اور ویب ہُک ہینڈلر کو قابلِ واپسی Shop Cash کیپچر کی ٹرانزیکشن کی شناخت کرنی چاہیے، اس کیپچر کے لیے بقیہ قابلِ واپسی رقم کا حساب لگانا چاہیے، اور کیپچر ٹرانزیکشن ID کے خلاف رقم کی واپسی تخلیق کرنی چاہیے۔

جب آپ Admin API، آرڈر ایکسپورٹ، پے آؤٹ ایکسپورٹ، یا تھرڈ پارٹی ایپ ایکسپورٹ استعمال کریں، تو Shop Cash کو ادائیگی کا ڈیٹا سمجھیں۔ آپ کی استعمال کردہ ایکسپورٹ یا API ریسورس کی بنیاد پر، Shop Cash کی معلومات کو ادائیگی کے طریقے، گیٹ وے، آرڈر ٹرانزیکشن، پے آؤٹ ٹرانزیکشن، اور رقم کی واپسی کے ڈیٹا کے ذریعے ظاہر کیا جا سکتا ہے۔

جب آپ کوئی انٹیگریشن بناتے یا اپ ڈیٹ کرتے ہیں، تو Shop Cash شامل کرنے والے آرڈر کے لیے درج ذیل معلومات محفوظ کریں:

• آرڈر ID اور آرڈر کا نام۔
• ادائیگی کا طریقہ یا گیٹ وے ویلیو، جیسے shop_cash جہاں دستیاب ہو۔
• ادائیگی کی ہر ٹرانزیکشن کے لیے آرڈر ٹرانزیکشن ID۔
• ٹرانزیکشن کی قسم اور اسٹیٹس، جیسے کہ آتھرائزیشن، کیپچر، رقم کی واپسی، یا کالعدم۔
• ٹرانزیکشن کی رقم اور کرنسی۔
• پیرنٹ ٹرانزیکشن کے تعلقات، جب دستیاب ہوں۔
• ادائیگی کی ID، جہاں دستیاب ہو۔
• اگر آپ کا سسٹم انہیں امپورٹ کرتا ہے، تو مکمل آتھرائزیشن ویلیوز۔
• پے آؤٹ کا ملان کرتے وقت پے آؤٹ ID اور بیلنس ٹرانزیکشن ID۔
• واپسی کا ملان کرتے وقت رقم کی واپسی کی ٹرانزیکشن ID۔

دستیاب Admin API فیلڈز کی تفصیلات کے لیے، Admin API آرڈر ٹرانزیکشن کے ڈیولپر ڈاکیومنٹیشن سے رجوع کریں۔ نئی انٹیگریشنز کے لیے OrderTransaction.authorizationCode جیسی متروک فیلڈز پر انحصار کرنے سے گریز کریں۔

درج ذیل آسان مثال ایک $100 USD کے آرڈر کو ظاہر کرتی ہے جس کی ادائیگی $75 USD Shopify Payments کے ذریعے اور $25 USD Shop Cash کے ذریعے کی گئی ہے۔ ویلیوز صرف تمثیلی ہیں۔

{
  "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 کو رعایت نہیں سمجھتے ہیں۔

اگر آپ ایک سے زیادہ سسٹمز استعمال کرتے ہیں، تو ہر اس سسٹم کے لیے یہ جائزہ مکمل کریں جو آرڈر، ٹرانزیکشن، پے آؤٹ، فل فلمنٹ، رقم کی واپسی، یا واپسی کا ڈیٹا وصول کرتا ہے۔