v1.1API ცნობარი

MultiPrime API

შექმენით ბარათით ან საფულით გადახდა თქვენი ბექენდიდან და შეამოწმეთ მისი საბოლოო სტატუსი. მომხმარებელი ბარათისა და საფულის მონაცემებს მხოლოდ MultiPrime-ის გადახდის გვერდზე შეიყვანს.

POST /cgi-bin/paymentinit.cgi · 200
{
  "success": true,
  "code": "PAYMENT_PAGE_CREATED",
  "paymentId": "GATEWAY_PAYMENT_ID",
  "redirectUrl": "HOSTED_PAYMENT_PAGE_URL",
  "redirectMethod": "POST"
}
ფორმატი
JSON
ხელმოწერა
HMAC-SHA256
ენდპოინტები
2

01 · მიმოხილვა

როგორ მუშაობს გადახდა

თქვენი ბექენდი ორ ენდპოინტს იყენებს: paymentinit.cgi გადახდის შესაქმნელად და paymentstatuscheck.cgi მისი გადამოწმებული სტატუსის შესამოწმებლად.

  1. ნაბიჯი 01

    გადახდის შექმნა

    თქვენი ბექენდი შეკვეთის მონაცემებით გამოიძახებს paymentinit.cgi-ს.

  2. ნაბიჯი 02

    გადამისამართება

    გადაამისამართეთ მომხმარებელი MultiPrime-ის გადახდის გვერდზე.

  3. ნაბიჯი 03

    შედეგის URL

    ბრაუზერი გადამოწმებული შედეგით ბრუნდება თქვენს შედეგის URL-ზე.

  4. ნაბიჯი 04

    სტატუსის შემოწმება

    შეკვეთის შესრულებამდე შეაჯერეთ სტატუსი paymentstatuscheck.cgi-ის მეშვეობით.

მაგალითებში გამოყენებული ცვლადები

ცვლადიაღწერა
BASEURLსაგადახდო კარიბჭის საბაზისო მისამართი შესაბამისი გარემოსთვის, მაგალითად BASEURL/cgi-bin/paymentinit.cgi.
MERCHANT_IDსაგადახდო კარიბჭის მიერ გაცემული მერჩანტის იდენტიფიკატორი.
API_KEYსაჯარო API გასაღები, რომელიც მერჩანტს არჩეული გარემოსთვის გადაეცემა.
API_SECRETსაიდუმლო გასაღები, რომლითაც მერჩანტის ბექენდი მოთხოვნებს ხელს აწერს. არასოდეს გაამჟღავნოთ ის ბრაუზერის JavaScript-ში.
MERCHANT_PAYMENT_IDთქვენი გადახდის ან შეკვეთის უნიკალური იდენტიფიკატორი. უნიკალური უნდა იყოს თითოეული მერჩანტის ფარგლებში.
MERCHANT_RESULT_URLთქვენი გვერდი ან ენდპოინტი, რომელზეც ბრაუზერი გადამოწმების შემდეგ ბრუნდება.

02 · ავთენტიფიკაცია

ხელმოწერილი მოთხოვნები

თქვენი ბექენდიდან საგადახდო კარიბჭისკენ გაგზავნილი ყოველი მოთხოვნა ამ ჰედერებს შეიცავს. ერთი და იგივე წესები ორივე ენდპოინტზე ვრცელდება.

ჰედერისავალდებულომნიშვნელობა
X-Merchant-IdდიახMERCHANT_ID
X-Api-KeyდიახAPI_KEY
X-TimestampდიახUnix დროის ნიშნული წამებში, UTC.
X-Nonceდიახუნიკალური შემთხვევითი მნიშვნელობა თითოეული მოთხოვნისთვის. რეკომენდებულია: მინიმუმ 16 ბაიტი, თექვსმეტობით ფორმატში.
X-SignatureდიახAPI_SECRET-ით გამოთვლილი HMAC-SHA256 ხელმოწერა Base64 ფორმატში.
Content-TypePOST-ისთვისapplication/json
Acceptრეკომენდებულიapplication/json
კანონიკური სტრიქონი და ხელმოწერა
# Canonical string: one value per line, in this order
HTTP_METHOD
REQUEST_PATH_WITH_QUERY
X-Timestamp
X-Nonce
SHA256_HEX(REQUEST_BODY)

# Signature
signature = BASE64( HMAC_SHA256(API_SECRET, canonical_string) )

# GET without a body: SHA-256 of the empty string
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
შეინახეთ API_SECRET მხოლოდ თქვენი ბექენდის კონფიგურაციაში. არასოდეს განათავსოთ ის ბრაუზერში შესრულებად JavaScript-ში.

03 · გადახდის შექმნა

გადახდის შექმნა

POSTBASEURL/cgi-bin/paymentinit.cgi

გამოიძახეთ ეს ენდპოინტი თქვენი ბექენდიდან, სანამ მომხმარებელს MultiPrime-ის გადახდის გვერდზე გადაამისამართებთ.

ველიაღწერა
merchantPaymentIdსტრიქონი · სავალდებულოთქვენი უნიკალური გადახდის ID შეჯერებისა და სტატუსის მოძიებისთვის.
referenceსტრიქონი · სავალდებულოშეკვეთის ადვილად წასაკითხი რეფერენსი. რეკომენდებულია: შეკვეთის ნომერი.
amountსტრიქონი · სავალდებულოთანხა ათწილადი რიცხვის სახით, წერტილის შემდეგ ორი ციფრით, მაგალითად "1.00".
currencyსტრიქონი · სავალდებულოვალუტის ISO კოდი, მაგალითად GEL.
resultUrlსტრიქონი · სავალდებულოთქვენი დაბრუნების მისამართი: MERCHANT_RESULT_URL.
descriptionსტრიქონი · რეკომენდებულიგადახდის გვერდზე ნაჩვენები ტექსტი, თუ ეს მხარდაჭერილია.
languageსტრიქონი · რეკომენდებულიბარათი: EN ან KA. Apple Pay: EN, KA ან RU. Google Pay: EN ან KA.
paymentMethodსტრიქონი · არასავალდებულოგადახდის გვერდის რეჟიმი. თუ არ არის მითითებული, გამოიყენება CARD.
resultDeliveryMethodსტრიქონი · არასავალდებულოPOST ან GET. რეკომენდებულია: POST.
saveCardლოგიკური · არასავალდებულოtrue მხოლოდ ბარათის ტოკენიზაციის აქტიური შეთანხმების არსებობისას.
bankCodeსტრიქონი · არასავალდებულოსასურველი საბანკო ჯგუფი. თუ არ არის მითითებული, გადახდის მარშრუტს საგადახდო კარიბჭე განსაზღვრავს.
bankNodeIdსტრიქონი · არასავალდებულოდამუშავების კვანძი, თუ ის თქვენი მერჩანტისთვის შეთანხმებულია.
metadataობიექტი · არასავალდებულოთქვენი არასენსიტიური მნიშვნელობები. ბარათის ან საფულის მონაცემები აქ არასოდეს უნდა იყოს.
მოთხოვნა · cURL
curl -X POST "BASEURL/cgi-bin/paymentinit.cgi" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-Merchant-Id: MERCHANT_ID" \
  -H "X-Api-Key: API_KEY" \
  -H "X-Timestamp: 1780000000" \
  -H "X-Nonce: 6b45e1f4c3f64a9a9d3e4219cb7f95c1" \
  -H "X-Signature: SIGNATURE" \
  -d '{
    "merchantPaymentId": "MERCHANT_PAYMENT_ID-100001",
    "reference": "ORDER-100001",
    "amount": "1.00",
    "currency": "GEL",
    "description": "Payment for order ORDER-100001",
    "language": "EN",
    "paymentMethod": "CARD",
    "resultUrl": "MERCHANT_RESULT_URL",
    "resultDeliveryMethod": "POST",
    "saveCard": false,
    "metadata": { "cartId": "CART-100001" }
  }'

04 · გადახდის მეთოდები

გადახდის გვერდის რეჟიმები

მოთხოვნა და ავთენტიფიკაცია უცვლელი რჩება. საფულის გვერდის გასახსნელად შეცვალეთ paymentMethod და დატოვეთ saveCard=false.

paymentMethodგადახდის გვერდიენები
CARDბარათით გადახდის სტანდარტული გვერდიEN, KA
APPLE_CARDბარათი + Apple PayEN, KA, RU
APPLE_PAYმხოლოდ Apple PayEN, KA, RU
GOOGLE_CARDბარათი + Google PayEN, KA
GOOGLE_PAYმხოლოდ Google PayEN, KA
ბარათი + Apple Pay · შეცვლილი ველები
{
  "paymentMethod": "APPLE_CARD",
  "language": "EN",
  "saveCard": false
}
თქვენ არასოდეს აგზავნით Apple Pay-ის ან Google Pay-ის ტოკენებს, PAN-ს, ბარათის მოქმედების ვადას, CVV-ს ან 3DS პაროლებს. გადახდის ავტორიზაციას მომხმარებელი MultiPrime-ის გადახდის გვერდზე ასრულებს.

05 · გადამისამართება

გადაამისამართეთ მომხმარებელი გადახდის გვერდზე

ყოველთვის მიჰყევით პასუხში მიღებულ redirectUrl-ს, redirectMethod-ს და redirectParams-ს. პასუხი ერთნაირია ბარათის, Apple Pay-ისა და Google Pay-ისთვის. თუ redirectMethod არის GET, გადაამისამართეთ ბრაუზერი redirectUrl-ზე და პარამეტრები გადაეცით URL-ის მოთხოვნის სტრიქონში.

პასუხი · 200
{
  "success": true,
  "code": "PAYMENT_PAGE_CREATED",
  "paymentId": "GATEWAY_PAYMENT_ID",
  "merchantPaymentId": "MERCHANT_PAYMENT_ID-100001",
  "gatewayTransactionId": "GATEWAY_TRANSACTION_ID",
  "reference": "ORDER-100001",
  "amount": "1.00",
  "currency": "GEL",
  "redirectUrl": "HOSTED_PAYMENT_PAGE_URL",
  "redirectMethod": "POST",
  "redirectParams": {
    "trans_id": "GATEWAY_TRANSACTION_ID"
  },
  "resultUrl": "MERCHANT_RESULT_URL",
  "resultDeliveryMethod": "POST",
  "message": "Payment page created"
}
redirectMethod = POST · ფორმის ავტომატური გაგზავნა
<form id="gatewayRedirect" method="POST"
      action="HOSTED_PAYMENT_PAGE_URL">
  <input type="hidden" name="trans_id"
         value="GATEWAY_TRANSACTION_ID">
</form>
<script>
  document.getElementById('gatewayRedirect').submit();
</script>

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

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