v1.1ტესტირება

Sandbox და სატესტო ბარათები

Sandbox-ის წვდომის მონაცემები, სინთეზური სატესტო ბარათები და სავალდებულო ტესტირების გეგმა დეველოპერებისა და QA გუნდებისთვის.

01 · Sandbox

Sandbox-ის წვდომის მონაცემები

MultiPrime თქვენი მერჩანტისთვის გასცემს Sandbox-ის წვდომის მონაცემებს: მერჩანტის ID-ს, API გასაღებს, API საიდუმლო გასაღებს და შედეგის/webhook-ის საიდუმლო გასაღებს. ერთდროულად გამოიყენეთ მხოლოდ ერთი Sandbox მერჩანტი.

წვდომის მონაცემიფორმატისად განთავსდება
მერჩანტის IDSANDBOX_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 კოდი.

ბარათის ნომერივადაCVV3DS OTPმოსალოდნელიკოდიშეტყობინება
4000 0000 0000 0002Visa12/34123111111APPROVED000დადასტურებული
5100 0000 0000 0008Mastercard12/34123111111APPROVED000დადასტურებული
4000 0000 0000 1166Visa12/34123111111DECLINED116უარყოფა, არასაკმარისი თანხა
4000 0000 0000 1299Visa12/34123111111DECLINED129სავარაუდოდ ყალბი ბარათი; ხელით გადამოწმების ნიშანი
4000 0000 0000 1257Visa12/34999111111DECLINED125CVV/CVC-ის შემოწმება ვერ გაიარა
4000 0000 0000 0549Visa01/20123111111DECLINED054ვადაგასული ბარათი
4000 0000 0000 0911Visa12/34123111111PENDING091ემიტენტი ან ექვაირერი დროებით მიუწვდომელია
4000 0000 0000 7775Visa12/34123000000DECLINED3DS_FAILED3DS ავთენტიფიკაცია ვერ შესრულდა
4000 0000 0000 8880Visa12/34123111111PENDINGTIMEOUTექვაირერის პასუხის ვადის ამოწურვის სიმულაცია; გაიმეორეთ სტატუსის შემოწმება
4000 0000 0000 9995Visa12/34123111111DECLINEDCANCELLEDმომხმარებელმა გადახდა გადახდის გვერდზე გააუქმა
5200 0000 0000 1161Mastercard12/34123111111DECLINED116უარყოფა, არასაკმარისი თანხა
5300 0000 0000 1293Mastercard12/34123111111DECLINED129სავარაუდოდ ყალბი ბარათი; ხელით გადამოწმების ნიშანი

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დადასტურებული Visa4000 0000 0000 0002დაასრულეთ 3DS ვერიფიკაცია OTP კოდით 111111.APPROVED, final=true, paymentApproved=true, resultCode=000
T02დადასტურებული Mastercard5100 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/CVC4000 0000 0000 1257გამოიყენეთ CVV 999.DECLINED, resultCode=125
T06ვადაგასული ბარათი4000 0000 0000 0549გამოიყენეთ მოქმედების ვადა 01/20.DECLINED, resultCode=054
T07წარუმატებელი 3DS4000 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ტესტიროგორ შესრულდესსავალდებულო შედეგი
R01POST, დადასტურებულიresultDeliveryMethod=POST, ბარათი დადასტურებული შედეგით.POST ველები final=true და paymentApproved=true მნიშვნელობებით.
R02POST, უარყოფილიresultDeliveryMethod=POST, ბარათი უარყოფის შედეგით.POST ველები final=true და paymentApproved=false მნიშვნელობებით.
R03GET, დადასტურებული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 რეჟიმის წვდომის მონაცემებს გავცემთ.