UAPAY - національний платіжний сервіс
Receiving payment data P2P (Show Payment)
This method is for viewing information and statuses for direct and broken transfers.
A show request is sent to receive information about the payment status. A unique transfer code is sent in the request. As a result, payment confirmation information is received.
URI
POST /api/payments/p2p/show
Request:
Key | Description | Type | required | Example |
|---|---|---|---|---|
params | ||||
sessionId | client session id | string, uuid | yes | "6d1b241b-6406-42a2-ae85-13d67b951841" |
id | ID of the transfer (operation) in the provider's system | string, uuid | yes, unless externalId is specified no if externalId is specified | "6bb07565-6602-4482-b695-bbf410506a7d" |
externalId | Agent transfer id | string | yes if id not specified no if id is specified | "123" |
code | Transfer code (from e-mail or phone) for interrupted payments | string | no | "12345678" |
Приклад запиту
{
"params":{
"sessionId":"6d1b241b-6406-42a2-ae85-13d67b951841",
"id":"6bb07565-6602-4482-b695-bbf410506a7d",
"externalId":"123",
"code":"12345678"
}
}response:
Key | Description | Type | Example |
|---|---|---|---|
status | Status. 0 - Error, 1 - Success | integer | 1 |
data | |||
id | ID of the transfer (operation) in the provider's system | string, uuid | "6bb07565-6602-4482-b695-bbf410506a7d " |
status | transfer status | string | "NEEDS_CONFIRMATION" |
number | Transfer number in the provider's system | string | "16851" |
amount | The amount of the transfer in the provider's system | integer | 100 |
confirmation.url | The address where to forward the client | string | "https://acs.privatbank.ua/ |
confirmation.type | Type of confirmation required (3DS or LOOKUP) | string | "3DS" |
confirmation.form.PaReq | A parameter object for generating queries on 3DS. transfer id in processing | string | "eJxVUttOwzAMfd5fVHxAc1 |
redirect.url | Data to form a link to return the client. The base part of the link | string | "https://api.demo.uapay.ua:443/ |
redirect.params.id | QueryString parameters the client can pass | string | "6bb07565-6602-4482-b695-bbf410506a7d" |
Можливі статуси платежів:
Status | Description |
|---|---|
PENDING | Paid. Intermediate status. After it, you need to use the method / api /payments/p2p/show to obtain final status (NEEDS_CONFIRMATION, FINISHED або REJECTED) |
NEEDS_CONFIRMATION | To edit, you must confirm. Confirmation is required to complete the withdrawal. |
FINISHED | Done. Final status. |
REJECTED | Rejected due to technical reasons. Final status. |
REVERSED | Returned. Final status. |
Приклад відповіді
{
"status":1,
"data":{
"id":"6bb07565-6602-4482-b695-bbf410506a7d",
"status":"NEEDS_CONFIRMATION",
"number":"16851",
"amount":100,
"externalId":"123",
"recipient":{
"phone":"380961234567",
"email":null
},
"confirmation":{
"type":"3DS",
"url":"https://acs.privatbank.ua/pPaReqMC.jsp",
"form":{
"PaReq":"eJxVUttOwzAMfd5fVHxAc1nTtVOINNgDk+g0wXjYE6o6i3WwrEtaYHw9dtqhESmqfY5j99jW650DmD9D1TkwugDvyzeI6u3tzWr2BKdXoWSaJmMpJ6lKbsxIB9iMRvoTnK+P1oiYx1Kzi4tMU1qjxulYJTLlUqlMcaUZoUgW4KpdaVu0R7qsTneLpcEaeSo0G1xiDuAWc8P7I/sPRvQwBdjyAGYNvo0uGaN16R9r+x5pFkiKqo6dbd3ZZDzR7OIQ0bkPs2vbZsqYkBOUwGMxHeNhxWrBnsA3R+th5Y4VtqS2b/HeN5rRK3zMrkToVUe27+t911tTrF/Oy/2GFz+L8/JnI5bz2VfR31vNKIIit2ULRnKRcSWySCRYfJpMNAt46M2BftekMekeHMIbqjcbSOKugaC5cw5sdTZ5xlH0xSMKvlEWYBwO7M8mQVci9P3DMJuqxV7LTOYqyZXkExpQwIZUNfYSR5OHXHVorGb0GvOFLaFGhYVC69+i/QK+brnK"
}
},
"redirect":{
"url":"https://api.demo.uapay.ua:443/api/payments/p2p/confirm",
"params":{
"id":"6bb07565-6602-4482-b695-bbf410506a7d"
}
}
}
}UAPAY - національний платіжний сервіс
pay@uapay.ua