Troubleshoot payments

Troubleshoot payments

Where to find payment logs

Payment requests to all payment providers (including your payment connector extensions) are logged in the order history

  • New payment request

  • Transaction status updates

  • Settlement requests

  • Refund requests

  • Webhook updates received from the PSP

image-20260312-084440.png

 

Archives and anonymisation

Payments logs are kept 15 days after the order has reach a final state. You can increase or decrease this retention in your payment configuration page.

image-20260312-084645.png

Payment logs are deleted when an anonymisation request is done for the order.

Setup webhook to receive payment errors

You can get notified of payment issues with 3 different entities:

  • Transaction - Represents a payment request with a particular PSP. It contains a list of Operations identifiers linked to this payment.
    Webhook : List of standard webhook topics

  • Operation - Depending of it’s type, represents an authorisation, capture or refund of funds made (or failed) on the PSP side for a given amount.
    Webhook : List of standard webhook topics

    • Type authorisation - Money withdrawal authorisation action. The money is accessible until the expiry date but will only be debited at the time of the capture request. An Authorisation only takes place in a deferred payment and is unique to a Transaction.

    • Type capture - Action of taking money. It may be automatic if the Authorisation linked to the Transaction expires.

    • Type refund - Refund action, the money is sent back to the customer.

  • Execution - Represents a trace of the actual execution of one or more Capture or Refund Operations.
    Webhook : List of standard webhook topics

Transaction workflow

mermaid-diagram-2025-06-11-142440.png

Operation (type authorisation) workflow

mermaid-diagram-2025-06-11-142328.png

Operation (type capture) workflow

mermaid-diagram-2025-06-11-142420.png

Operation (type refund) workflow

mermaid-diagram-2025-06-11-142353.png

Execution workflow

mermaid-diagram-2025-06-11-142506.png