ინტეგრაცია
ოთხი ნაბიჯი პირველ გადახდამდე
ეს არის გადახდის გვერდის მთელი ინტეგრაცია. დანარჩენი ამ ოთხი ნაბიჯის დეტალებია.
სავარჯიშო და საბრძოლო შლუზის საბაზისო მისამართი გაიცემა გასაღებებთან ერთად. ქვემოთ მოცემულ მაგალითებში ის აღნიშნულია როგორც $MP_API_BASE.
- 01მიიღე სავარჯიშო გასაღებები
გამოგვიგზავნი განაცხადს, ჩვენ გაძლევთ სატესტო გასაღებებს, საბაზისო მისამართს და სპეციფიკაციას ველების სახელებითა და შეცდომების კოდებით. სავარჯიშო გარემოში თანხა არ ჩამოიჭრება.
- 02შექმენი გადახდა
ერთი მოთხოვნა. პასუხში მიიღებ გადახდის იდენტიფიკატორს და ბმულს გადახდის გვერდზე.
curl -X POST "$MP_API_BASE/payments" \ -H "Authorization: Bearer $MP_KEY" \ -H "Content-Type: application/json" \ -d '{ "amount": "40.00", "currency": "GEL", "orderId": "shop-4412", "description": "1 Day Membership, Coffee", "callbackUrl": "https://shop.example/payments/callback", "returnUrl": "https://shop.example/orders/4412" }' - 03გაუშვი კლიენტი გვერდზე
გადამისამართება პასუხში მიღებულ ბმულზე. კლიენტი იხდის და ბრუნდება შენს returnUrl-ზე. ბრაუზერის დაბრუნება გადახდის დადასტურება არ არის: ის მხოლოდ იმას ნიშნავს, რომ ბრაუზერი დაბრუნდა.
{ "id": "pay_8f2b41c7", "status": "created", "paymentUrl": "https://pay.multiprime.ge/i/8f2b41c7" } - 04მიიღე callback და დაადასტურე სტატუსი
სტატუსი მოდის შენს callbackUrl-ზე. შეამოწმე ხელმოწერა, შემდეგ კიდევ ერთხელ წაიკითხე გადახდა და მხოლოდ ამის შემდეგ გასცე საქონელი. callback შეიძლება ორჯერ მოვიდეს, ამიტომ დამმუშავებელი იდემპოტენტური უნდა იყოს.
curl "$MP_API_BASE/payments/pay_8f2b41c7" \ -H "Authorization: Bearer $MP_KEY"