Өтініш
Сұрау параметрлері
| Есім | Параметр түрі | Әдепкі мән | Анықтама |
|---|---|---|---|
| address* | string | Қайтару керек мекен-жайы | |
| is_subtract* | boolean | Саудагердің балансынан немесе қайтару сомасынан комиссия алу керек пе true - Комиссияны сауда балансынан алыңыз false - КОМИССИЯНЫҢ СОҢҒЫ ӨНДІРУ ӨНДІРІНЕ ЖАҢА | |
| uuid* | uuidrequired_without: order_id | Шот-фактура UUID | |
| order_id* | stringmin:1max:128alpha_dashrequired_without: uuid | Шот-фактураның өтінімі | |
| amount | stringmax:40null | null | Қайтару сомасы |
Параметр түрі
stringАнықтама
Қайтару керек мекен-жайыПараметр түрі
booleanАнықтама
Саудагердің балансынан немесе қайтару сомасынан комиссия алу керек пе true - Комиссияны сауда балансынан алыңыз false - КОМИССИЯНЫҢ СОҢҒЫ ӨНДІРУ ӨНДІРІНЕ ЖАҢАПараметр түрі
uuidrequired_without: order_idАнықтама
Шот-фактура UUIDПараметр түрі
stringmin:1max:128alpha_dashrequired_without: uuidАнықтама
Шот-фактураның өтініміПараметр түрі
stringmax:40nullАнықтама
Қайтару сомасы
* - Міндетті параметр
Мысал сұрау
curl https://api.heleket.com/v1/payment/refund \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
"uuid": "8b03432e-385b-4670-8d06-064591096795",
"address": "TDD97yguPESTpcrJMqU6h2ozZbibv4Vaqm",
"is_subtract": "true",
}'Жауап
Жауаптың мысалы
1{
2 "state": 0,
3 "result": []
4}Мүмкін қателер
Тексеру қателері
код : 422
Мысал жауаптары:
Егер сіз ұсынған uuid немесе ordre_id -мен шот-фактура жоқ болса:
1{
2 "state": 1,
3 "message": "Payment was not found"
4} Егер сіз uuid tock_id өтпесеңіз, сіз бұл хабарламаны аласыз. Бұл дегеніміз, кем дегенде, параметрлердің біреуі қажет екенін білдіреді.
1{
2 "state": 1,
3 "errors": {
4 "uuid": ["validation.required_without"],
5 "order_id": ["validation.required_without"]
6 }
7}Егер саудагерлерде төлемдер бұғатталған болса, сіз осы қате туралы хабарлама аласыз. Бұл, мысалы, парольді өзгерткен кезде және төлемдер 24 сағат бойы бұғатталған кезде.
1{
2 "state": 1,
3 "message": "You are forbidden"
4}
5Егер шот-фактурамен байланысты сауда әмияны болмаса:
1{
2 "state": 1,
3 "message": "Undefined merchant wallet"
4}Егер шот-фактура аяқталмаса немесе төленбесе.
1{
2 "state": 1,
3 "message": "Refunds are made only for completed payments"
4}Егер қайтарылатын сома шот-фактураны төлеу сомасынан асып кетсе:
1{
2 "state": 1,
3 "message": "The refund amount should not be more than the amount paid"
4}Егер техникалық жұмыс орын алса және төлем уақытша қол жетімді болмаса, сіз осы қате туралы хабарламаны ала аласыз:
1{
2 "state": 1,
3 "message": "Server error"
4}