ინტეგრაცია თქვენს სერვისთან

შეკვეთის შექმნა

მეთოდის გამოყენება public/exchanger/order/create

ავტორიზაციის სისტემის დოკუმენტაცია შეგიძლიათ იხილოთ თქვენს პირად კაბინეტში. მეთოდებთან მუშაობისა და დამატებითი მონაცემების შესახებ მეტი ინფორმაცია შეგიძლიათ იხილოთ

IPN (შეტყობინება გადახდის მოთხოვნის სტატუსის ცვლილების შესახებ)

შეკვეთის სტატუსის ცვლილების შეტყობინების მისაღებად, შეკვეთის შექმნისას საჭიროა დამატებითი პარამეტრების გაგზავნა:

• clientCallbackUrl - განაცხადის დასრულების შემდეგ კლიენტი დაინახავს უკან დაბრუნების ღილაკს და კლიენტი გადამისამართდება ამ URL-ზე
• hideOutData - მიმღების რეკვიზიტების დამალვა
• ipnUrl - HTTP/HTTPS ბმული თქვენი სერვერის შეტყობინებისთვის.
• ipnSecret - შემთხვევითი სტრიქონი მოთხოვნის ხელმოწერის შესაქმნელად (მოთხოვნის მთლიანობის შესანარჩუნებლად)

1. მოთხოვნა გაიგზავნება POST მეთოდით
2. IPN გაიგზავნება ერთხელ
3. IPN-ის მიწოდება არ არის გარანტირებული (თუ სერვერი არ უპასუხა მოთხოვნას, ის ხელახლა არ გაიგზავნება)

IPN-ის მაგალითი

• POST
• ['Content-Type'] = 'application/x-www-form-urlencoded'



• orderUID :Number() - შეკვეთა uid
• orderId :String(ObjectId) -შეკვეთა id
• newStatus :String() - შეკვეთა მიმდინარე სტატუსი
• inAmount :String(number) - order in sum
• outAmount :String(number) - order out sum
• xml_from :String() - შეკვეთა uid
• xml_to :String() - შეკვეთა uid
• timestamp :Number() - IPN შეტყობინების unix დრო
• toValues :Array([{key,name,value}]) - შეკვეთის რეკვიზიტები

სტატუსების სია

• new - ახალი შეკვეთა
• waitPayment - მომხმარებლის გადახდის მოლოდინი
• errorPayment - მომხმარებლის გადახდის შეცდომა (მერჩანტმა გაგზავნა შეცდომა)
• inProgress - მუშავდება (ელოდება ადმინისტრატორს ან განაცხადის გადახდას)
• inProgressPayout - გადახდის რიგში (გადახდა წარმატებით მიღებულია) (თუ კონფიგურირებულია ვალუტის ავტოგადახდა, ის ინიციალიზდება)
• errorPayout - გადახდის შეცდომა (გადახდისას მოხდა შეცდომა)
• hold - გაყინული (პრობლემა განაცხადთან)
• done - შეკვეთა წარმატებით დასრულდა
• returned - შეკვეთა გადახდილია, მაგრამ გაცვლის ყველა პირობა არ შესრულდა და თანხა დაბრუნდა გამგზავნს
• deleted - შეკვეთა წაშლილია (გაუქმებულია)

მოთხოვნის საკონტროლო ჯამის ვერიფიკაცია (IPN)

sha256(orderId:newStatus:inAmount:outAmount:xml_from:xml_to:timestamp:ipnSecret)

        
const stringForHash = orderId+":"+newStatus+":"+inAmount+":"+outAmount+":"+xml_from+":"+xml_to+":"+timestamp+":"+ipnSecret;
// example string for hash 5d8e6002b80b7b4cd75a6424:inProgress:2:317.42:ETH:WMZ:1571328406072:SECRET123

const hash = crypto.createHash('sha256').update(stringForHash).digest('hex')
// example hash af3acf947e6f0e0f2c267e300b8582e504dba12d1f2d058652b7414163c09f48
        
      

გადახდის კონტროლი

1. თუ გჭირდებათ მოთხოვნების სტატუსის კონტროლი, შექმენით ისინი ავტორიზაციის გამოყენებით, შემდეგ ყველა მოთხოვნა აისახება თქვენს პირად კაბინეტში;
2. შეგიძლიათ შეინახოთ მოთხოვნის UID და საიდუმლო კოდი და ხელით გადახვიდეთ მოთხოვნაზე ამ მონაცემების მისამართის ზოლში მითითებით

გადახდა

1. შეგიძლიათ გამოიყენოთ /payment/ გადახდის გვერდის საჩვენებლად
   
   // schema
https://exchange.gecrypto.com/user-lang/payment/order-uid/order-secret
// example result
https://exchange.gecrypto.com/en/payment/1409/dGqwF2M2eBPaSN1G5ljMS1cb
2. ასევე შეგიძლიათ უბრალოდ მისცეთ ბმული გაცვლაზე, როგორც ხედავენ ყველა კლიენტი იმავე სქემით, როგორც მითითებულია პირველ ვარიანტში, გარდა იმისა, რომ /payment/ უნდა შეიცვალოს /order/-ით
3. მეთოდში არის პარამეტრები, რომლებიც საშუალებას გაძლევთ აჩვენოთ გადახდის მონაცემები ან გადახდის ფორმა თქვენს საიტზე. მნიშვნელოვანი: თუ მეთოდი ხელით გადახდითაა, საჭიროა შეკვეთის სტატუსის განახლება waitPayment-დან inProgress-ზე გადახდის შემდეგ.