v1.1API ცნობარი
შედეგები და სტატუსი
მიიღეთ გადამოწმებული შედეგი თქვენს საიტზე, შეამოწმეთ საბოლოო სტატუსი და შეკვეთის შესრულებამდე დაამუშავეთ ყველა შესაძლო შემთხვევა.
{
"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-ის პარამეტრებად მოდის.
| ველი | მნიშვნელობა |
|---|---|
| success | true, თუ სტატუსი დადასტურებულია. |
| final | true, თუ ექვაირერის სტატუსი საბოლოოა. |
| paymentApproved | true მხოლოდ დადასტურებული გადახდებისთვის. |
| status | APPROVED, DECLINED, PENDING, FAILED ან UNKNOWN. |
| paymentId | გადახდის ID საგადახდო კარიბჭეში. |
| merchantPaymentId | თქვენი გადახდის ID paymentinit-ის მოთხოვნიდან. |
| gatewayTransactionId | ტრანზაქციის ID ექვაირერის ან საგადახდო კარიბჭის მხარეს. |
| reference | თქვენი შეკვეთის რეფერენსი. |
| amount · currency | გადახდის თანხა და ვალუტა. |
| resultCode | ექვაირერის ან საგადახდო კარიბჭის შედეგის კოდი უცვლელი სახით. |
| resultCodeType | APPROVAL, DECLINE, ERROR ან PENDING. |
| resultCodeDescription | ლოკალიზებული განმარტება მომხმარებლისთვის საჩვენებლად ან მხარდაჭერის სამსახურისთვის. |
| rrn · approvalCode | ბანკის რეფერენსები, თუ გადმოცემულია. სანდოა მხოლოდ APPROVED სტატუსის დროს. |
| maskedCardNumber | ბარათის ნაწილობრივ დაფარული ნომერი, თუ გადმოცემულია. |
| message | შეტყობინება მომხმარებლისთვის ან მხარდაჭერის სამსახურისთვის. |
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=Approvedfinal=true. ნებისმიერ გაურკვეველ შემთხვევაში გამოიყენეთ სტატუსის შემოწმება.07 · გადახდის სტატუსი
შეამოწმეთ გადახდის სტატუსი
GETBASEURL/cgi-bin/paymentstatuscheck.cgi
გამოიყენეთ ის ყოველთვის, როცა მიმდინარე გადამოწმებული სტატუსი გჭირდებათ. მოთხოვნა გააგზავნეთ ერთ-ერთი პარამეტრით: paymentId, merchantPaymentId ან trans_id (საგადახდო კარიბჭის ტრანზაქციის ID).
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"{
"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"
}{
"success": true,
"final": true,
"paymentApproved": false,
"status": "DECLINED",
"resultCode": "116",
"resultCodeType": "DECLINE",
"resultCodeDescription":
"Decline, not sufficient funds",
"maskedCardNumber": "400000******1166"
}{
"success": true,
"final": false,
"paymentApproved": false,
"status": "PENDING",
"resultCode": "PENDING",
"resultCodeType": "PENDING",
"resultCodeDescription":
"Payment is not final yet"
}08 · შეცდომები
შეცდომის პასუხები
| HTTP | კოდი | მნიშვნელობა | რა უნდა გააკეთოთ |
|---|---|---|---|
| 400 | BAD_REQUEST | აკლია სავალდებულო ველი, ან არასწორია paymentMethod ან ენა. | შეასწორეთ მოთხოვნა. გამოიყენეთ მხარდაჭერილი მეთოდი და ენა. |
| 401 | AUTH_FAILED | მერჩანტის ავთენტიფიკაცია ვერ შესრულდა. | შეამოწმეთ MERCHANT_ID, API_KEY, დროის ნიშნული, ერთჯერადი მნიშვნელობა (X-Nonce) და ხელმოწერა. |
| 403 | SIGNATURE_INVALID | ხელმოწერა არ შეესაბამება მოთხოვნას. | ხელახლა გამოთვალეთ კანონიკური სტრიქონი და HMAC. |
| 404 | PAYMENT_NOT_FOUND | ამ მერჩანტისთვის ასეთი გადახდა არ არსებობს. | შეამოწმეთ paymentId, merchantPaymentId ან trans_id. |
| 409 | DUPLICATE_MERCHANT_PAYMENT_ID | ასეთი merchantPaymentId უკვე არსებობს. | ახალი შეკვეთისთვის merchantPaymentId ხელახლა არ გამოიყენოთ. |
| 422 | AMOUNT_INVALID | თანხა ან ვალუტა არასწორია. | გააგზავნეთ თანხა ათწილადი სტრიქონის სახით და მხარდაჭერილი ვალუტა. |
| 503 | STATUS_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 რეჟიმზე გადასვლამდე გაიარეთ სავალდებულო ტესტირების გეგმა.