Tarkibga o'tish

PCI DSS standarti talablariga muvofiq savdogarlar uchun buyurtma yarating

Ushbu endpointlar sotuvchining PCI DSS standartiga muvofiqlik jarayoni va karta ma'lumotlari sotuvchi nomidan yig'ilish jarayoniga tegishli sayt yoki ilova.

Note

Ushbu jarayon ikki bosqichdan iborat bo'ladi.

  • 1-qadam: Chiqaruvchi bankdan ACS URL manzilini oling va karta egasini 3D Secure autentifikatsiya uchun ushbu URL manziliga yo'naltiring.

  • 2-qadam: ACS URL orqali natijani oling va moliyaviy tranzaksiyani — xaridni — yakunlang.

Buyurtma yaratish uchun API manzili

Step 1. Starting 3DSecure authentication

POST /api/3dsecure_step1

Ushbu API manzili POST so'rovini JSON formatida va so'rov parametrlari bilan kutadi.

Agar karta 3D-Secure xizmatiga ulangan bo'lsa, javob quyidagi parametrlarni o'z ichiga oladi:

Parametr Tur Tavsif
response_status string(50) Agar xatolik bo'lmasa, 'success' har doim qaytariladi success
acs_url string(2048) Karta egasining chiqaruvchi bankining kirishni nazorat qilish serverining URL manzili, bu yerda ular 3D Secure parolini kiritishi kerak
pareq string(20480) acs_url manziliga yuborilishi kerak bo'lgan parametr
md string(1024) Yagona 3DSecure so'rov identifikatori. Payme to'lov darvozasi tomonidan yaratilgan

Ushbu javobni olgan savdogar HTML-formani yaratishi va uni mijozning ma'lumotlarini acs_url manziliga yuborish uchun ishlatishi kerak. HTML-formada quyidagilar bo'lishi lozim:

<form name="MPIform" action='${acs_url}' method="POST">
  <input type="hidden" name="PaReq" value='${pareq}'>
  <input type="hidden" name="MD" value='${md}'>
  <input type="hidden" name="TermUrl" value='${TermUrl}'>
</form>

${TermUrl} — bu acs_url saytida 3D Secure autentifikatsiyadan so'ng mijoz qayta yo'naltiriladigan savdogarning URL manzili.

Karta egasining paroli tasdiqlangach, quyidagi parametrlar TermUrl URL manziliga qaytariladi:

Parametr Tur Tavsif
juftliklar string(20480) result.Is to'lovchi autentifikatsiyasi BASE64 satri
md string(1024) Payme to'lov darvozasi tomonidan yuborilgan noyob ID.Generated so'rovi

So'rov/javob misollari

curl -i -X POST \
-H "Content-Type:application/json" \
-d \
'
{
  "request": {
    "order_id": "test_12343242",
    "merchant_id": "4056281",
    "order_desc": "Test order",
    "amount": 1000,
    "currency": "UZS",
    "card_number": "4444555566661111",
    "cvv2": "111",
    "expiry_date": "1125",
    "client_ip": "8.8.8.8",
    "server_callback_url": "https://myserver.com/callback",
    "signature": "0c0c2374c73267e7be560d80834e4ba28ccda7aa"
  }
}
' \
'https://pay.payme.uz/api/3dsecure_step1'
{
    "response": {
        "response_status": "success",
        "acs_url": "https://pay.payme.uz/test/testacs/",
        "pareq": "eJxtU21vgjAQ/u6vIP4A+gJRNKVJHUvUiRpwS/aRYYNsgljA6b8fLTpFuISE5+5pe/fcHdnsBOeOz8NScNrTKiMuz/Mg4lq8tfuDyqxRv46o6Jp5/HjHynfiIo8PKUU61DEBN9gkuVyEuyAtmm4VCsLjZLakpjUyDUTAFbZ5CRczhxpDDCsjoIZtWhoknC7Y5mM2Z762Zv6GaRO2fGMEqFD7RHgo00JcqIktAm6gTSvFnu6KIsvHQD6uysn1ffal708EyGizZNBdM1mX0p13ZXKOt9R12O/Th5ffn3jl/NgESEb73DYoOMUQmdDCloaGY4jGaECA8nconsgiKdYh1F7fvUrz2tFmZjJXdqVL1R8dHUqWQvA0vNDRUEp5Q20iP2eHlMtLCfj/f5KvWyfyMu2cobCopsFNVsZ8yhdHL1rNkedH0Ev8yLblVClCZyZx1W4DozqV+Ln3BDy+WKV1XwHZYrUttEdAY5f+AHcC0ak=",
        "md": "2001876637"
    }
}

So'rov/javob misollari

{
    "response": {
        "error_code": 1011,
        "error_message": "Parameter `amount` is missing",
        "request_id": "5htKi0wf7zEHn",
        "response_status": "failure"
    }
}

3D Secure autentifikatsiyani yakunlash uchun API manzili

Step 2. Complete 3D-Secure authentication and perform purchase transaction

POST /api/3dsecure_step2

Ushbu API manzili POST manziliga JSON formatida quyidagi parametrlar bilan so'rov yuborilishini kutadi:

Parametr Tur Majburiy Tavsif
savdogar_id butun son(12) majburiy Yagona savdogar identifikatori. Savdogar ro'yxatdan o'tganida Payme tomonidan yaratiladi.
order_id string(1024) majburiy Savdochi tomonidan yaratilgan buyurtma identifikatori.
juftliklar string(20480) majburiy Parolni tasdiqlagandan so'ng TermUrl URL manzilida chiqaruvchi bank tomonidan qaytariladigan parametr
md string(1024) majburiy Yagona 3DSecure so'rov identifikatori. Payme to'lov darvozasi tomonidan yaratilgan
versiya string(10) ixtiyoriy Protokol versiyasi. Standart qiymat: 1.0
imzo string(40) majburiy Buyurtma imzosi. Savdogarning so'rovi haqiqiyligini va asl ekanligini tasdiqlash uchun zarur. Imzo yaratish algoritmi uchun qarang: Imzo yaratish.

Request

curl -i -X POST \
-H "Content-Type:application/json" \
-d \
'
{
    "request": {
        "order_id": "test_123432421",
        "merchant_id": "4056281",
        "pares": "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",
        "md": "2003330322",
        "signature": "32b08ca114659b8c18ab9576cf1d5ffdb9c711f2"
    }
}
' \
'https://pay.payme.uz/api/3dsecure_step2'
{
    "response": {
        "error_code": 1011,
        "error_message": "Parameter `amount` is missing",
        "request_id": "5htKi0wf7zEHn",
        "response_status": "failure"
    }
}