v1.1API ცნობარი

შედეგები და სტატუსი

მიიღეთ გადამოწმებული შედეგი თქვენს საიტზე, შეამოწმეთ საბოლოო სტატუსი და შეკვეთის შესრულებამდე დაამუშავეთ ყველა შესაძლო შემთხვევა.

GET /cgi-bin/paymentstatuscheck.cgi · 200
{
  "success": true,
  "code": "PAYMENT_STATUS_CHECKED",
  "final": true,
  "paymentApproved": true,
  "status": "APPROVED",
  "merchantPaymentId": "MERCHANT_PAYMENT_ID-100001",
  "resultCode": "000",
  "resultCodeType": "APPROVAL",
  "maskedCardNumber": "411111******1111"
}

06 · შედეგის URL

შედეგის მიწოდება თქვენს საიტზე

გადახდის გვერდის შემდეგ საგადახდო კარიბჭე რეალურ სტატუსს ექვაირერთან ამოწმებს და ბრაუზერს თქვენს resultUrl-ზე აბრუნებს. POST-ის შემთხვევაში მიიღეთ application/x-www-form-urlencoded ველები; GET-ის შემთხვევაში იგივე ველები URL-ის პარამეტრებად მოდის.

ველიმნიშვნელობა
successtrue, თუ სტატუსი დადასტურებულია.
finaltrue, თუ ექვაირერის სტატუსი საბოლოოა.
paymentApprovedtrue მხოლოდ დადასტურებული გადახდებისთვის.
statusAPPROVED, DECLINED, PENDING, FAILED ან UNKNOWN.
paymentIdგადახდის ID საგადახდო კარიბჭეში.
merchantPaymentIdთქვენი გადახდის ID paymentinit-ის მოთხოვნიდან.
gatewayTransactionIdტრანზაქციის ID ექვაირერის ან საგადახდო კარიბჭის მხარეს.
referenceთქვენი შეკვეთის რეფერენსი.
amount · currencyგადახდის თანხა და ვალუტა.
resultCodeექვაირერის ან საგადახდო კარიბჭის შედეგის კოდი უცვლელი სახით.
resultCodeTypeAPPROVAL, DECLINE, ERROR ან PENDING.
resultCodeDescriptionლოკალიზებული განმარტება მომხმარებლისთვის საჩვენებლად ან მხარდაჭერის სამსახურისთვის.
rrn · approvalCodeბანკის რეფერენსები, თუ გადმოცემულია. სანდოა მხოლოდ APPROVED სტატუსის დროს.
maskedCardNumberბარათის ნაწილობრივ დაფარული ნომერი, თუ გადმოცემულია.
messageშეტყობინება მომხმარებლისთვის ან მხარდაჭერის სამსახურისთვის.
POST-ის მონაცემები · დადასტურებული
success=true
final=true
paymentApproved=true
status=APPROVED
paymentId=GATEWAY_PAYMENT_ID
merchantPaymentId=MERCHANT_PAYMENT_ID-100001
gatewayTransactionId=GATEWAY_TRANSACTION_ID
reference=ORDER-100001
amount=1.00
currency=GEL
gatewayResult=OK
resultCode=000
resultCodeType=APPROVAL
resultCodeDescription=Approved
rrn=618207038139
approvalCode=247651
maskedCardNumber=411111******1111
message=Approved
ბრაუზერის პირველი დაბრუნება საბოლოოდ ჩათვალეთ მხოლოდ მაშინ, როცა final=true. ნებისმიერ გაურკვეველ შემთხვევაში გამოიყენეთ სტატუსის შემოწმება.

07 · გადახდის სტატუსი

შეამოწმეთ გადახდის სტატუსი

GETBASEURL/cgi-bin/paymentstatuscheck.cgi

გამოიყენეთ ის ყოველთვის, როცა მიმდინარე გადამოწმებული სტატუსი გჭირდებათ. მოთხოვნა გააგზავნეთ ერთ-ერთი პარამეტრით: paymentId, merchantPaymentId ან trans_id (საგადახდო კარიბჭის ტრანზაქციის ID).

მოთხოვნა · cURL
curl -X GET "BASEURL/cgi-bin/paymentstatuscheck.cgi?merchantPaymentId=MERCHANT_PAYMENT_ID-100001" \
  -H "Accept: application/json" \
  -H "X-Merchant-Id: MERCHANT_ID" \
  -H "X-Api-Key: API_KEY" \
  -H "X-Timestamp: 1780000011" \
  -H "X-Nonce: 413685e8fa6d4a0b9f9af7a4a602b0fb" \
  -H "X-Signature: SIGNATURE"
პასუხი · APPROVED
{
  "success": true,
  "code": "PAYMENT_STATUS_CHECKED",
  "final": true,
  "paymentApproved": true,
  "status": "APPROVED",
  "merchantPaymentId": "MERCHANT_PAYMENT_ID-100001",
  "amount": "1.00",
  "currency": "GEL",
  "resultCode": "000",
  "resultCodeType": "APPROVAL",
  "requiresManualReview": false,
  "rrn": "618207038139",
  "approvalCode": "247651",
  "maskedCardNumber": "411111******1111"
}
პასუხი · DECLINED
{
  "success": true,
  "final": true,
  "paymentApproved": false,
  "status": "DECLINED",
  "resultCode": "116",
  "resultCodeType": "DECLINE",
  "resultCodeDescription":
    "Decline, not sufficient funds",
  "maskedCardNumber": "400000******1166"
}
პასუხი · PENDING
{
  "success": true,
  "final": false,
  "paymentApproved": false,
  "status": "PENDING",
  "resultCode": "PENDING",
  "resultCodeType": "PENDING",
  "resultCodeDescription":
    "Payment is not final yet"
}

08 · შეცდომები

შეცდომის პასუხები

HTTPკოდიმნიშვნელობარა უნდა გააკეთოთ
400BAD_REQUESTაკლია სავალდებულო ველი, ან არასწორია paymentMethod ან ენა.შეასწორეთ მოთხოვნა. გამოიყენეთ მხარდაჭერილი მეთოდი და ენა.
401AUTH_FAILEDმერჩანტის ავთენტიფიკაცია ვერ შესრულდა.შეამოწმეთ MERCHANT_ID, API_KEY, დროის ნიშნული, ერთჯერადი მნიშვნელობა (X-Nonce) და ხელმოწერა.
403SIGNATURE_INVALIDხელმოწერა არ შეესაბამება მოთხოვნას.ხელახლა გამოთვალეთ კანონიკური სტრიქონი და HMAC.
404PAYMENT_NOT_FOUNDამ მერჩანტისთვის ასეთი გადახდა არ არსებობს.შეამოწმეთ paymentId, merchantPaymentId ან trans_id.
409DUPLICATE_MERCHANT_PAYMENT_IDასეთი merchantPaymentId უკვე არსებობს.ახალი შეკვეთისთვის merchantPaymentId ხელახლა არ გამოიყენოთ.
422AMOUNT_INVALIDთანხა ან ვალუტა არასწორია.გააგზავნეთ თანხა ათწილადი სტრიქონის სახით და მხარდაჭერილი ვალუტა.
503STATUS_UNAVAILABLEექვაირერის სტატუსის გადამოწმება ამ ეტაპზე ვერ მოხერხდა.მოგვიანებით გაიმეორეთ სტატუსის შემოწმება.

09 · შეკვეთის დამუშავება

როდის უნდა მონიშნოთ შეკვეთა გადახდილად

საგადახდო კარიბჭის სტატუსიქმედება შეკვეთაზე
APPROVEDმონიშნეთ შეკვეთა გადახდილად და გააგრძელეთ შეკვეთის შესრულება.
DECLINEDშეკვეთა არ შეასრულოთ. აჩვენეთ უარის შეტყობინება და მიეცით გადახდის ხელახლა ცდის შესაძლებლობა.
PENDINGშეკვეთა არ შეასრულოთ. პერიოდულად გამოიძახეთ სტატუსის შემოწმება ან დაელოდეთ შედეგის მიწოდებას შედეგის URL-ზე.
FAILED UNKNOWNშეკვეთა არ შეასრულოთ. აჩვენეთ მხარდაჭერის შეტყობინება და საჭიროების შემთხვევაში გადახდა ხელით შეაჯერეთ.

ინტეგრაციის წესები

  • paymentinit-ის გამოძახებამდე შექმენით უნიკალური merchantPaymentId და შეინახეთ ის შეკვეთასთან ერთად.
  • შეინახეთ paymentId და gatewayTransactionId paymentinit-ის პასუხიდან.
  • APPLE_CARD, APPLE_PAY, GOOGLE_CARD და GOOGLE_PAY მეთოდებისთვის გააგზავნეთ saveCard=false.
  • Apple Pay-ის რეჟიმებისთვის გამოიყენეთ EN, KA ან RU, ხოლო Google Pay-ის რეჟიმებისთვის EN ან KA.
  • თქვენს შედეგის URL-ზე მიიღეთ POST ფორმის ველები ან GET მოთხოვნის პარამეტრები.
  • მოლოდინში მყოფი, შეწყვეტილი ან ბრაუზერის დახურვის გამო დაუსრულებელი გადახდები შეაჯერეთ სტატუსის შემოწმების მეშვეობით.
  • შეკვეთის გადახდილად მონიშვნამდე გადაამოწმეთ თანხა, ვალუტა, merchantPaymentId, რეფერენსი და სტატუსი.
  • არასოდეს გააგზავნოთ ბარათის ან საფულის ავტორიზაციის მონაცემები paymentinit.cgi-ზე.

მზად ხართ ინტეგრაციის დასატესტად?

გამოიყენეთ Sandbox-ის წვდომის მონაცემები და სინთეზური სატესტო ბარათები, შემდეგ კი LIVE რეჟიმზე გადასვლამდე გაიარეთ სავალდებულო ტესტირების გეგმა.