v1.1API ცნობარი
MultiPrime API
შექმენით ბარათით ან საფულით გადახდა თქვენი ბექენდიდან და შეამოწმეთ მისი საბოლოო სტატუსი. მომხმარებელი ბარათისა და საფულის მონაცემებს მხოლოდ MultiPrime-ის გადახდის გვერდზე შეიყვანს.
{
"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 მისი გადამოწმებული სტატუსის შესამოწმებლად.
- ნაბიჯი 01
გადახდის შექმნა
თქვენი ბექენდი შეკვეთის მონაცემებით გამოიძახებს paymentinit.cgi-ს.
- ნაბიჯი 02
გადამისამართება
გადაამისამართეთ მომხმარებელი MultiPrime-ის გადახდის გვერდზე.
- ნაბიჯი 03
შედეგის URL
ბრაუზერი გადამოწმებული შედეგით ბრუნდება თქვენს შედეგის URL-ზე.
- ნაბიჯი 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-Type | POST-ისთვის | 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
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855API_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 -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 Pay | EN, KA, RU |
| APPLE_PAY | მხოლოდ Apple Pay | EN, KA, RU |
| GOOGLE_CARD | ბარათი + Google Pay | EN, KA |
| GOOGLE_PAY | მხოლოდ Google Pay | EN, KA |
{
"paymentMethod": "APPLE_CARD",
"language": "EN",
"saveCard": false
}05 · გადამისამართება
გადაამისამართეთ მომხმარებელი გადახდის გვერდზე
ყოველთვის მიჰყევით პასუხში მიღებულ redirectUrl-ს, redirectMethod-ს და redirectParams-ს. პასუხი ერთნაირია ბარათის, Apple Pay-ისა და Google Pay-ისთვის. თუ redirectMethod არის GET, გადაამისამართეთ ბრაუზერი redirectUrl-ზე და პარამეტრები გადაეცით URL-ის მოთხოვნის სტრიქონში.
{
"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"
}<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 რეჟიმზე გადასვლამდე გაიარეთ სავალდებულო ტესტირების გეგმა.