Kartalar
Mijoz kartasini SMS kod orqali ulash
Mijoz externalUserId bilan aniqlanadi, bu sizning tizimingizdagi foydalanuvchi identifikatori. Mijozni alohida
yaratish shart emas: u birinchi karta ulanganda paydo bo'ladi.
Ulash
Avtorizatsiya
bearer Qayerda: header
Sarlavhalar
8 dan 128 gacha [A-Za-z0-9._:-] belgi, har bir operatsiya uchun yagona
^[A-Za-z0-9._:-]{8,128}$So'rov tanasi
application/json
TypeScript turlari
TypeScript da request body turidan foydalaning.
Javob tanasi
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/cards" \ -H "Idempotency-Key: string" \ -H "Content-Type: application/json" \ -d '{ "externalUserId": "user-42", "cardNumber": "8600123456789012", "expiryMonth": 9, "expiryYear": 29, "phone": "998901234567" }'{ "success": true, "meta": { "requestId": "string", "timestamp": "2019-08-24T14:15:22Z", "processingTimeMs": 0 }, "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "externalUserId": "string", "status": "PENDING_CONFIRMATION", "mask": "string", "expiry": "string", "otpSentPhone": "string", "createdAt": "2019-08-24T14:15:22Z" }}Avtorizatsiya
bearer Qayerda: header
Yo'l parametrlari
uuidSo'rov tanasi
application/json
TypeScript turlari
TypeScript da request body turidan foydalaning.
Javob tanasi
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/cards/497f6eca-6276-4993-bfeb-53cbbbba6f08/confirm" \ -H "Content-Type: application/json" \ -d '{ "otp": "111111" }'{ "success": true, "meta": { "requestId": "string", "timestamp": "2019-08-24T14:15:22Z", "processingTimeMs": 0 }, "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "externalUserId": "string", "status": "PENDING_CONFIRMATION", "mask": "string", "expiry": "string", "otpSentPhone": "string", "createdAt": "2019-08-24T14:15:22Z" }}POST /v1/cardskarta raqami va amal qilish muddati bilan →PENDING_CONFIRMATIONholati, karta egasiga SMS keladi.POST /v1/cards/{id}/confirmkod bilan →ACTIVEholati.
Agar aynan shu karta mijozga allaqachon ulangan va faol bo'lsa, 1-qadam uni SMS yubormasdan darhol qaytaradi. Tasdiqlanmagan kartani qayta ulash oldingi urinishning o'rnini egallaydi: "kodni qayta yuborish" shunday ishlaydi.
Nimani saqlaymiz
Faqat provayder tokeni, 860012******9012 ko'rinishidagi niqob, amal qilish muddati va takrorlarni topish uchun
barmoq izi. Karta raqamining to'liq ko'rinishi hech qayerda saqlanmaydi.
Kassalar o'rtasida kirish
Sukut bo'yicha mijoz kartalari biznesingizning barcha kassalari uchun umumiy. Kassa sozlamalarida "faqat shu kassa" rejimini yoqish mumkin. Turli bizneslarning kartalari bir-biriga hech qachon ko'rinmaydi.
Ro'yxat va uzish
Avtorizatsiya
bearer Qayerda: header
Yo'l parametrlari
Javob tanasi
application/json
application/json
application/json
curl -X GET "https://example.com/v1/customers/string/cards"{ "success": true, "meta": { "requestId": "string", "timestamp": "2019-08-24T14:15:22Z", "processingTimeMs": 0 }, "data": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "externalUserId": "string", "status": "PENDING_CONFIRMATION", "mask": "string", "expiry": "string", "otpSentPhone": "string", "createdAt": "2019-08-24T14:15:22Z" } ]}Avtorizatsiya
bearer Qayerda: header
Yo'l parametrlari
uuidJavob tanasi
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/v1/cards/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "success": true, "meta": { "requestId": "string", "timestamp": "2019-08-24T14:15:22Z", "processingTimeMs": 0 }, "data": { "removed": true }}GET /v1/customers/{externalUserId}/cardskassa uchun mavjud faol kartalarni qaytaradi.DELETE /v1/cards/{id}kartani uzadi.