All Collections
Merchant
Fintecture back-office
What is the mapping convention between the payment statuses in the Console and the API statuses?
What is the mapping convention between the payment statuses in the Console and the API statuses?
Farouk Belhadri avatar
Written by Farouk Belhadri
Updated over a week ago

As we aim at making our Console as user-friendly as possible, we have translated our API payment statuses into easily understandable statuses that reflect the payment process in the Fintecture back-office.

Please, find the mapping convention below.

Console Statuses

API payment status

Products

Meaning

PAYMENT_CREATED

BNPL, Immediate Transfer, Payout, Refund, Smart Transfer

The payment is confirmed and guaranteed.

PAYMENT_PENDING

Immediate Transfer, Refund, Smart Transfer

Awaiting funds (the payment is not guaranteed at this point)

PROVIDER_REQUIRED or SCA_REQUIRED when initial_payment_type='RequestToPay'

Immediate Transfer, Request to Pay, Smart Transfer

Awaiting an payment confirmation action from the user

PAYMENT_PARTIAL

Smart Transfer

A part of the total amount expected was received.

N/A: applies to payment_created with transfer_state = ‘overpaid’

Smart Transfer

Funds superior to the total amount expected were received.

PAYMENT_UNSUCCESSFUL

BNPL, Immediate Transfer, Refund

The payer has encountered an error upon attempting to pay.

PAYMENT_CANCELLED

BNPL, Immediate Transfer, Payout, Refund, Smart Transfer

You have cancelled the payment and no longer expect the funds.

PAYMENT_EXPIRED

BNPL, Immediate Transfer, Payout, Smart Transfer

The expiration date you have set for this payment has been reached.

N/A

BNPL, Immediate Transfer, Smart Transfer

The payment is flagged due to suspicious activity.

PENDING_VALIDATION

Payout

A third party validation is necessary for the payment to be processed.

Refund waiting

N/A: applies to sessions with refund_status = 'refund_waiting’

Refund

Refund pending. Applies to refunds from payment or Fintecture accounts.

IBAN_REQUIRED

Payout, Refund

The recipient of the payment needs to proceed with their identification for us to retrieve their IBAN.

IBAN_RECEIVED

Payout, Refund

The recipient of the payment proceeded with their identification and we retrieved their IBAN.

Please, note that these are subject to change as we keep improving our payment solutions.

Did this answer your question?