After Consumer is redirected back to your environment, get payment details by sending us Get payment details request.
Response body will contain all information about the payment. In addition to payment data provided in Payment Initiation request, Response will have set of various statuses and Consumer details.
Note! When testing in Stage environment Get payment details API does not return debtor IBAN in response body.
Our Gateway provides these statuses (parameter status.code
) :
Initiated | Payment initiation request received from Merchant. |
PendingMerchant | Payment initiation response sent to Merchant. |
InProgress | Redirect received from Merchant. |
Processing | Payment initiation request sent to Provider. |
PendingProvider | Redirect received from Provider OR Payment status update received from Provider, however payment status is not terminal. |
Approved | Payment approved. |
Settled | Funds has been received in Merchant Account. Currently, in non-prod you will receive this status only for Apple Pay and Google Pay top up transactions. If you want to test it, inform us, and our dev-support will change Approved transactions to Settled. Important! Some PIS payment method providers send funds faster than we receive approval from them (in SEPA INST cases), thus there is a case where you might receive this status before Approved. |
Failed | Payment failed. |
Abandoned | Payment canceled or abandoned at Provider OR Session expires OR Consumer cancels payment before initiating it. |
Refunded | Payment was refunded. |
PendingRefund | Refund is in progress. |
PartialyRefunded | Partial amount of a payment was refunded. |
To uderstand if status is terminal, check status.isTerminal
: Boolean finalisation indicator:
- True – if payment is finalised and it‘s status won‘t change.
- False – payment is not completed yet.
Tips! There are some exemptions with terminal status when it’s moving from one terminal state to another:
- Approved → Settled. When funds are settled, we notify you separately. Currently commercial card transactions don’t have this status for delayed settlement, this is why 2 states can be terminal.
- Approved/Settled → Refunded/PartialyRefunded. If your customer required a refund, we move one terminal state to another terminal state that is related to refund action. Usually before changing state to Refunded/PartialyRefunded we add one intermediate status PendingRefund while we process a refund.
- Settled → Approved. This change can happens only for SEPA INST payments and it’s caused by asynchronous notifications. Sometimes funds are received faster than response from a bank.