v1.1ტესტირება
Sandbox და სატესტო ბარათები
Sandbox-ის წვდომის მონაცემები, სინთეზური სატესტო ბარათები და სავალდებულო ტესტირების გეგმა დეველოპერებისა და QA გუნდებისთვის.
01 · Sandbox
Sandbox-ის წვდომის მონაცემები
MultiPrime თქვენი მერჩანტისთვის გასცემს Sandbox-ის წვდომის მონაცემებს: მერჩანტის ID-ს, API გასაღებს, API საიდუმლო გასაღებს და შედეგის/webhook-ის საიდუმლო გასაღებს. ერთდროულად გამოიყენეთ მხოლოდ ერთი Sandbox მერჩანტი.
| წვდომის მონაცემი | ფორმატი | სად განთავსდება |
|---|---|---|
| მერჩანტის ID | SANDBOX_MERCHANT_001 | მოთხოვნის ჰედერი X-Merchant-Id |
| API გასაღები | pk_test_… | მოთხოვნის ჰედერი X-Api-Key |
| API საიდუმლო გასაღები | sk_test_… | მხოლოდ ბექენდის კონფიგურაციაში. გამოიყენება მოთხოვნების ხელმოსაწერად. |
| შედეგის / webhook-ის საიდუმლო გასაღები | whsec_test_… | მხოლოდ ბექენდის კონფიგურაციაში. |
სატესტო ბარათები მუშაობს მხოლოდ Sandbox-ის სიმულატორში და საწარმოო გარემოში არასოდეს ჩაირთვება.
ტესტირებამდე
- თქვენი ბექენდის კონფიგურაციაში მიუთითეთ Sandbox-ის MERCHANT_ID, API_KEY და API_SECRET.
- მიუთითეთ MERCHANT_RESULT_URL და უზრუნველყავით, რომ ის POST ფორმის ველებს იღებდეს.
- გადახდები შექმენით მოთხოვნით BASEURL/cgi-bin/paymentinit.cgi.
- სტატუსის შესაჯერებლად გამოიყენეთ BASEURL/cgi-bin/paymentstatuscheck.cgi.
- ყოველი სატესტო გადახდისთვის შეინახეთ merchantPaymentId, paymentId, gatewayTransactionId, თანხა, ვალუტა და რეფერენსი.
02 · სატესტო ბარათები
სინთეზური სატესტო ბარათები
Sandbox-ის გადახდის გვერდზე გამოიყენეთ ამ ბარათებიდან ნებისმიერი. მოთხოვნის შემთხვევაში შეიყვანეთ 3DS OTP კოდი.
| ბარათის ნომერი | ვადა | CVV | 3DS OTP | მოსალოდნელი | კოდი | შეტყობინება |
|---|---|---|---|---|---|---|
| 4000 0000 0000 0002Visa | 12/34 | 123 | 111111 | APPROVED | 000 | დადასტურებული |
| 5100 0000 0000 0008Mastercard | 12/34 | 123 | 111111 | APPROVED | 000 | დადასტურებული |
| 4000 0000 0000 1166Visa | 12/34 | 123 | 111111 | DECLINED | 116 | უარყოფა, არასაკმარისი თანხა |
| 4000 0000 0000 1299Visa | 12/34 | 123 | 111111 | DECLINED | 129 | სავარაუდოდ ყალბი ბარათი; ხელით გადამოწმების ნიშანი |
| 4000 0000 0000 1257Visa | 12/34 | 999 | 111111 | DECLINED | 125 | CVV/CVC-ის შემოწმება ვერ გაიარა |
| 4000 0000 0000 0549Visa | 01/20 | 123 | 111111 | DECLINED | 054 | ვადაგასული ბარათი |
| 4000 0000 0000 0911Visa | 12/34 | 123 | 111111 | PENDING | 091 | ემიტენტი ან ექვაირერი დროებით მიუწვდომელია |
| 4000 0000 0000 7775Visa | 12/34 | 123 | 000000 | DECLINED | 3DS_FAILED | 3DS ავთენტიფიკაცია ვერ შესრულდა |
| 4000 0000 0000 8880Visa | 12/34 | 123 | 111111 | PENDING | TIMEOUT | ექვაირერის პასუხის ვადის ამოწურვის სიმულაცია; გაიმეორეთ სტატუსის შემოწმება |
| 4000 0000 0000 9995Visa | 12/34 | 123 | 111111 | DECLINED | CANCELLED | მომხმარებელმა გადახდა გადახდის გვერდზე გააუქმა |
| 5200 0000 0000 1161Mastercard | 12/34 | 123 | 111111 | DECLINED | 116 | უარყოფა, არასაკმარისი თანხა |
| 5300 0000 0000 1293Mastercard | 12/34 | 123 | 111111 | DECLINED | 129 | სავარაუდოდ ყალბი ბარათი; ხელით გადამოწმების ნიშანი |
03 · სატესტო ბრძანებები
სავალდებულო სატესტო მოთხოვნები
სატესტო გადახდის შექმნა
paymentinit · cURL
curl -X POST "BASEURL/cgi-bin/paymentinit.cgi" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "X-Merchant-Id: SANDBOX_MERCHANT_ID" \
-H "X-Api-Key: SANDBOX_API_KEY" \
-H "X-Timestamp: 1780000000" \
-H "X-Nonce: 6b45e1f4c3f64a9a9d3e4219cb7f95c1" \
-H "X-Signature: SIGNATURE" \
-d '{
"merchantPaymentId": "QA-ORDER-0001",
"reference": "QA-ORDER-0001",
"amount": "1.00",
"currency": "GEL",
"description": "QA test payment QA-ORDER-0001",
"language": "EN",
"resultUrl": "MERCHANT_RESULT_URL",
"resultDeliveryMethod": "POST",
"saveCard": false
}'მოსალოდნელი პასუხი
{
"success": true,
"code": "PAYMENT_PAGE_CREATED",
"paymentId": "GATEWAY_PAYMENT_ID",
"merchantPaymentId": "QA-ORDER-0001",
"gatewayTransactionId": "GATEWAY_TRANSACTION_ID",
"redirectUrl": "HOSTED_PAYMENT_PAGE_URL",
"redirectMethod": "POST",
"redirectParams": {
"trans_id": "GATEWAY_TRANSACTION_ID"
},
"resultUrl": "MERCHANT_RESULT_URL",
"resultDeliveryMethod": "POST"
}შეამოწმეთ მისი სტატუსი
paymentstatuscheck · cURL
curl -X GET "BASEURL/cgi-bin/paymentstatuscheck.cgi?merchantPaymentId=QA-ORDER-0001" \
-H "Accept: application/json" \
-H "X-Merchant-Id: SANDBOX_MERCHANT_ID" \
-H "X-Api-Key: SANDBOX_API_KEY" \
-H "X-Timestamp: 1780000010" \
-H "X-Nonce: 2e98f878c60e4dfbb94bba4fa65c5e3f" \
-H "X-Signature: SIGNATURE"მოსალოდნელი პასუხი
{
"success": true,
"code": "PAYMENT_STATUS_CHECKED",
"final": true,
"paymentApproved": true,
"status": "APPROVED",
"merchantPaymentId": "QA-ORDER-0001",
"resultCode": "000",
"resultCodeType": "APPROVAL",
"resultCodeDescription": "Approved"
}04 · ტესტირების გეგმა
სავალდებულო სატესტო სცენარები
LIVE წვდომის მოთხოვნამდე შეასრულეთ ყველა სცენარი 1.00 თანხით.
| ID | სცენარი | ბარათი | ქმედება | მოსალოდნელი შედეგი |
|---|---|---|---|---|
| T01 | დადასტურებული Visa | 4000 0000 0000 0002 | დაასრულეთ 3DS ვერიფიკაცია OTP კოდით 111111. | APPROVED, final=true, paymentApproved=true, resultCode=000 |
| T02 | დადასტურებული Mastercard | 5100 0000 0000 0008 | დაასრულეთ 3DS ვერიფიკაცია OTP კოდით 111111. | APPROVED, final=true, resultCode=000 |
| T03 | არასაკმარისი თანხა | 4000 0000 0000 1166 | დაასრულეთ 3DS ვერიფიკაცია OTP კოდით 111111. | DECLINED, resultCode=116 |
| T04 | სავარაუდოდ ყალბი ბარათი | 4000 0000 0000 1299 | დაასრულეთ 3DS ვერიფიკაცია OTP კოდით 111111. | DECLINED, resultCode=129, requiresManualReview=true |
| T05 | არასწორი CVV/CVC | 4000 0000 0000 1257 | გამოიყენეთ CVV 999. | DECLINED, resultCode=125 |
| T06 | ვადაგასული ბარათი | 4000 0000 0000 0549 | გამოიყენეთ მოქმედების ვადა 01/20. | DECLINED, resultCode=054 |
| T07 | წარუმატებელი 3DS | 4000 0000 0000 7775 | გამოიყენეთ OTP 000000 ან გააუქმეთ 3DS. | DECLINED, resultCode=3DS_FAILED |
| T08 | ექვაირერის პასუხის ვადის ამოწურვა | 4000 0000 0000 8880 | დაასრულეთ სიმულატორის მითითებების შესაბამისად. | თავიდან PENDING; სტატუსის შემოწმების გამეორება უსაფრთხოა |
| T09 | მომხმარებლის მიერ გაუქმება | 4000 0000 0000 9995 | გააუქმეთ გადახდის გვერდზე. | DECLINED ან CANCELLED, შედეგის კოდის შესაბამისობის მიხედვით |
| T10 | დუბლირებული გადახდის ID | ნებისმიერი ბარათი დადასტურებული შედეგით | ორჯერ გამოიძახეთ paymentinit ერთი და იმავე merchantPaymentId-ით. | მეორე გამოძახება აბრუნებს DUPLICATE_MERCHANT_PAYMENT_ID შეცდომას |
| T11 | არასწორი ხელმოწერა | — | გააგზავნეთ არასწორი X-Signature. | სრულდება AUTH_FAILED ან SIGNATURE_INVALID შეცდომით |
| T12 | მხარდაუჭერელი ვალუტა | — | გააგზავნეთ მხარდაუჭერელი ვალუტა. | ვალიდაციის შეცდომა; გადახდის გვერდი არ იქმნება |
შედეგის URL-ის ტესტები
| ID | ტესტი | როგორ შესრულდეს | სავალდებულო შედეგი |
|---|---|---|---|
| R01 | POST, დადასტურებული | resultDeliveryMethod=POST, ბარათი დადასტურებული შედეგით. | POST ველები final=true და paymentApproved=true მნიშვნელობებით. |
| R02 | POST, უარყოფილი | resultDeliveryMethod=POST, ბარათი უარყოფის შედეგით. | POST ველები final=true და paymentApproved=false მნიშვნელობებით. |
| R03 | GET, დადასტურებული | resultDeliveryMethod=GET, ბარათი დადასტურებული შედეგით. | ბრაუზერი ბრუნდება, შედეგის ველები კი URL-ის მოთხოვნის სტრიქონშია. |
| R04 | ბრაუზერის დახურვა | მცდელობის შემდეგ დახურეთ ბრაუზერი, მერე კი გამოიძახეთ სტატუსის შემოწმება. | თქვენ საბოლოო სტატუსს API-ის მეშვეობით შეაჯერებთ. |
| R05 | შედეგის URL მიუწვდომელია | გარკვეული დროით დააყენეთ MERCHANT_RESULT_URL ისე, რომ შეცდომას აბრუნებდეს. | საგადახდო კარიბჭე საბოლოო სტატუსს ინახავს; თქვენ მას სტატუსის შემოწმებით შეაჯერებთ. |
05 · LIVE რეჟიმზე გადასვლა
მიღების კრიტერიუმები
- paymentinit აბრუნებს ველებს: paymentId, gatewayTransactionId, redirectUrl, redirectMethod და redirectParams.
- მომხმარებლის ბრაუზერი დაბრუნებული გადამისამართების მონაცემებით გადადის MultiPrime-ის გადახდის გვერდზე.
- შედეგის URL-ზე მიწოდებამდე საგადახდო კარიბჭე სტატუსს ექვაირერთან ამოწმებს.
- სტატუსის შემოწმება აბრუნებს იმავე საბოლოო სტატუსს, რომელიც შედეგის URL-ზე გაიგზავნა.
- შეკვეთები გადახდილად მხოლოდ მაშინ მოინიშნება, როცა status=APPROVED და paymentApproved=true.
- უარყოფილი, მოლოდინში მყოფი, წარუმატებელი და უცნობი გადახდები გადახდილად არასოდეს მოინიშნება.
- დუბლირებული merchantPaymentId უარყოფილია, ან ბრუნდება არსებული გადახდა.
- არასწორი ხელმოწერის მქონე მოთხოვნები უარყოფილია.
ყველა ტესტი წარმატებით გაიარეთ?
გამოგვიგზავნეთ თქვენი შედეგები და თქვენი მერჩანტისთვის LIVE რეჟიმის წვდომის მონაცემებს გავცემთ.