Authorize.Net

آپ کو کیا درکار ہے

API Login ID اور Transaction Key ہمیشہ ساتھ ساتھ سفر کرتے ہیں۔ Signature Key آزاد ہے۔

ہم ہر فیلڈ کیوں مانگتے ہیں

API Login ID

API کالز پر آپ کے اکاؤنٹ کا نام رکھتی ہے۔ یہ صرف اُسی وقت کام کرتی ہے جب Transaction Key کے ساتھ جوڑی جائے۔

Transaction Key

وہ خفیہ جو ثابت کرتی ہے کہ ایک API درخواست آپ کی ہے۔ API Login ID کے ساتھ، یہ ہمیں میزبان ادائیگی فارم بنانے دیتی ہے، تاکہ چارج آپ کے اکاؤنٹ کے ذریعے چلے۔

Signature Key

ثابت کرتی ہے کہ آنے والا webhook واقعی Authorize.Net سے ہے، تاکہ کوئی بھی جعلی "paid" ایونٹ نہ بنا سکے۔ یہ Transaction Key سے ایک الگ قدر ہے۔

Success and Cancel URL

سادہ ترتیبات: ادائیگی کے بعد یا واپس ہٹنے کے بعد خریدار کہاں پہنچتا ہے۔ خفیہ نہیں۔

سیٹ اپ

1. ایک مفت سینڈ باکس اکاؤنٹ بنائیں (کوئی ادائیگی نہیں)

   ٹیسٹ کرنے کے لیے آپ کو ادائیگی شدہ مرچنٹ اکاؤنٹ کی ضرورت نہیں۔ Authorize.Net ایک مفت سینڈ باکس پیش کرتا ہے جو پروڈکشن کی نقل کرتا ہے، بغیر کسی کریڈٹ کارڈ کے۔

   1. developer.authorize.net/hello_world/sandbox.html پر جائیں اور ایک سینڈ باکس اکاؤنٹ کے لیے سائن اپ کریں۔ وہی لنک استعمال کریں، مرکزی سائن اپ یا قیمتوں کا صفحہ نہیں (جو ادائیگی شدہ لائیو درخواست ہے)۔
   2. sandbox.authorize.net پر سینڈ باکس Merchant Interface میں سائن اِن کریں۔

   دستخط کا اسکیم پروڈکشن کے بالکل یکساں ہے، تو جو کچھ بھی آپ سینڈ باکس میں تصدیق کرتے ہیں وہ لائیو میں اُسی طرح برتاؤ کرتا ہے۔

2. اپنے تینوں اسناد کاپی کریں

   سینڈ باکس اور لائیو دونوں میں ایک ہی راستہ: Account → Settings → Security Settings → General Security Settings → API Credentials and Keys۔

   • API Login ID اوپر دکھائی جاتی ہے۔
   • Transaction Key: "New Transaction Key" منتخب کریں، تصدیق کریں، اور فوراً کاپی کریں (یہ ایک بار دکھائی جاتی ہے)۔
   • Signature Key: "New Signature Key" منتخب کریں، تصدیق کریں، اور فوراً کاپی کریں۔

   ⤢
3. webhook شامل کریں
   1. Account → Settings → Business Settings → Webhooks، ایک endpoint شامل کریں۔
   2. endpoint URL کو اپنے پروجیکٹ کے webhook پتے پر سیٹ کریں (نیچے)۔
   3. ایونٹس کی رکنیت لیں۔ ایک-بار کی ادائیگیاں: net.authorize.payment.authorization.created, authcapture.created, capture.created, priorAuthCapture.created, refund.created, void.created، اور fraud.* ایونٹس (held, approved, declined)۔ سبسکرپشنز (Automated Recurring Billing): net.authorize.customer.subscription.* ایونٹس۔ تجدیدیں authcapture.created کے طور پر آتی ہیں، جو پہلے ہی شامل ہیں۔ اضافی ایونٹس بے ضرر ہیں۔
   4. محفوظ کریں۔ Authorize.Net ہر ترسیل پر آپ کی Signature Key سے دستخط کرتا ہے۔

   https://api.coinmoebius.com/webhook/authorizenet/<your project id>

   ⤢

   Coin Moebius ہر ایونٹ id کو ایک بار ریکارڈ کرتا ہے اور نقول کو نظر انداز کرتا ہے، تو دوبارہ چلائے گئے webhooks آپ کے لیے سنبھال لیے جاتے ہیں۔

4. سینڈ باکس کارڈز سے ٹیسٹ کریں

   سینڈ باکس کارڈز کبھی کسی حقیقی کارڈ پر چارج نہیں کرتے۔ کوئی بھی مستقبل کی میعاد (مثلاً 12/2030) اور کوئی بھی CVV (3 ہندسے، یا American Express کے لیے 4) استعمال کریں۔

   نیٹ ورک	کارڈ
   Visa	4111111111111111
   Mastercard	5424000000000015
   American Express	370000000000002
   Discover	6011000000000012

5. ڈیش بورڈ میں منسلک کریں

   Add provider → Authorize.Net۔ Success URL، Cancel URL، اور Live گروپ (API Login ID، Transaction Key، Signature Key) درج کریں۔ ٹیسٹ کرنے کے لیے اختیاری Sandbox گروپ شامل کریں۔ Sandbox گروپ سب-یا-کچھ نہیں ہے: تینوں فیلڈز، یا کوئی نہیں۔ لائیو اور سینڈ باکس الگ الگ جانچے جاتے ہیں۔

منسلک کرنے کے بعد

لائیو ہونے سے پہلے ایک ٹیسٹ ادائیگی چلائیں:

1. ایک پروڈکٹ بنائیں اور اس کا Environment Testing پر سیٹ کریں۔ یہ پروڈکٹ کو آپ کے سینڈ باکس اسناد پر چلاتا ہے، تو آپ رقم منتقل کیے بغیر مکمل آرڈر دے سکتے ہیں۔ (اگر آپ نے سینڈ باکس سیٹ چھوڑ دیا، تو ایک Testing پروڈکٹ لائیو پر واپس آ جاتی ہے، تو پہلے اسے شامل کریں۔)
2. buy button کو ایک ایسے صفحے پر رکھیں (ایک مقامی HTML فائل کام کرتی ہے) جو آپ کے پروجیکٹ کی طرف اشارہ کرتا ہو۔
3. اوپر دیے گئے سینڈ باکس ٹیسٹ کارڈ سے چیک آؤٹ مکمل کریں۔
4. Transactions ٹیب کھولیں۔ ایک نئی قطار ظاہر ہوتی ہے، Testing کے ٹیگ کے ساتھ۔ جب اس کی حیثیت succeeded تک پہنچے، تو آپ کے اسناد اور webhook دونوں سرے سے سرے تک کام کر رہے ہیں۔

جب آپ حقیقی ادائیگیوں کے لیے تیار ہوں تو پروڈکٹ کا Environment Live پر سوئچ کریں۔

مسائل کا حل

Verify سے شروع کریں۔ ڈیش بورڈ میں، اپنی API Login ID اور Transaction Key جانچنے کے لیے Verify (یا سینڈ باکس سیٹ کے لیے Verify test credentials) پر کلک کریں۔

Verify ناکام ہو جاتا ہے۔

API Login ID اور Transaction Key ایک ہی اکاؤنٹ (لائیو یا سینڈ باکس) کی جوڑی ہونی چاہیے۔ دونوں دوبارہ کاپی کریں۔

دستخط کی تصدیق ناکام ہو جاتی ہے۔

Signature Key، Transaction Key سے ایک مختلف قدر ہے۔ Signature Key کو اُسی اسکرین سے کاپی کریں۔ اسکیم سینڈ باکس اور لائیو میں یکساں ہے۔

ادائیگی مکمل ہو جاتی ہے مگر آرڈر pending رہتا ہے۔

تصدیق کریں کہ webhook URL بالکل مطابقت رکھتا ہے اور کہ آپ نے ادائیگی کے ایونٹس کی رکنیت لی۔

ایک ٹیسٹ پروڈکٹ نے ایک لائیو کارڈ چارج کیا۔

ٹیسٹ کے طور پر نشان زدہ ایک پروڈکٹ، جب کوئی مکمل سینڈ باکس سیٹ ترتیب نہ ہو، تو آپ کے لائیو اسناد پر واپس آ جاتی ہے۔ تینوں سینڈ باکس فیلڈز شامل کریں، یا پروڈکٹ سے ٹیسٹ کا نشان ہٹا دیں۔

سرے سے سرے تک تصدیق کریں۔

Authorize.Net صرف غیر فعال webhooks کو پنگ کرتا ہے: endpoint کو غیر فعال سیٹ کریں، ایک پنگ بھیجیں، پھر اسے دوبارہ فعال کریں، اور آرڈر کو اپ ڈیٹ ہوتے دیکھیں۔

جاننا اچھا ہے

ٹوکن قلیل المدت ہوتے ہیں. میزبان فارم ٹوکن تقریباً 15 منٹ تک رہتا ہے۔ ہم فی چیک آؤٹ ایک تازہ بناتے ہیں۔

کرنسی. Authorize.Net بنیادی طور پر ایک US، USD گیٹ وے ہے۔ غیر-USD آپ کے پروسیسر معاہدے پر منحصر ہے۔

کلیدیں گھمانا. کسی بھی وقت ایک نئی Transaction Key یا Signature Key بنائیں، پھر اسے پیسٹ کریں۔ خفیہ فیلڈز ترمیم پر خالی رہتی ہیں۔

سوالات؟ Join our Discord