List your payments and transactions

📘

First read our Get paid with Bridge and Payments statuses sections to understand how to create payments and reconcile them.

From the dashboard

Access all your payments and their final status on the Payments page. Additionally, view related transactions in and out on your Bridge account on the Transactions page.

Payments

Payments

Transactions

Transactions

From the API

To follow your payments statuses, you need to base your integration on two components : payment requests and payment links. Please check Payments statuses for more details. This section focuses on the new information available to you thanks to the payment account.

Payment requests

You can list and filter payment requests by their payment_account_transaction status.

Possible statuses include : NOT_RECEIVED, RECEIVED, PENDING_REFUND, PARTIALLY_REFUNDED, REFUNDED, RECALLED.

Example:https://api.bridgeapi.io/v2/payment-requests?transactions.payment_account_transaction.status=RECEIVED

{
    "resources": [
        {
            "id": "dbeff5c857c2453c9b1514aa47606e9f",
            "status": "ACSC",
            "user": {
                "first_name": "John",
                "last_name": "Doe",
                "external_reference": "pay-link-168621116141622566653315§",
                "ip_address": "90.3.254.217"
            },
            "sender": {
                "iban": "FR74XXXXXXXXXXXXXXXXXXXXT28",
                "name": "John Doe"
            },
            "transactions": [
                {
                    "id": "1f071461e3e440bbb085ac9f21dad2df",
                    "status": "ACSC",
                    "beneficiary": {
                        "iban": "FR76XXXXXXXXXXXXXXXXXXXX064",
                        "company_name": "Your Company"
                    },
                    "amount": 3.0,
                    "currency": "EUR",
                    "label": "BP69A3O1WO593TLTCLXG9GBD",
                    "payment_account_transaction": {
                        "status": "RECEIVED",
                    		"id": "02a1ac21-5d9b-4704-a8d3-ddde09adcbb2"
                    },
                    "execution_date": "2023-06-08"
                }
            ],
            "bank_id": 122,
            "payment_link_id": "68e1c1ab-1287-46dd-8747-e54a6468861d",
            "created_at": "2023-06-08T11:46:46.883Z",
            "updated_at": "2023-06-08T11:47:26.544Z"
        },

Payment links

You can also list payments links and get the fund_information status and the associated payment_account_transaction.

Possible fund_information statuses include : UNPAID, UNDERPAID, PAID, OVERPAID, RECALLED, PENDING_REFUND, REFUNDED or PARTIALLY_REFUNDED.

{
            "id": "fdbfa488-f1df-4edc-92a9-27c21111f816",
            "status": "COMPLETED",
            "user": {
                "first_name": "John",
                "last_name": "Doe",
                "external_reference": "ext123"
            },
            "link": "https://pay.bridgeapi.io/link/e5464ec214e48240b8e2e313b7689ab8ef058s22v1d2d51d7107fca30c993c25",
            "transactions": [
                {
                    "amount": 100.0,
                    "label": "Shop payment",
                    "end_to_end_id": "AJD-CCVDD",
                    "currency": "EUR",
                    "beneficiary": {
                        "iban": "FR03XXXXXXXXXXXXXXXXXXXX120",
                        "company_name": "Shop"
                    }
                }
            ],
            "fund_information": {
                "status": "PAID",
                "payment_account_transactions": [
                    {
                        "id": "01c2dc19-2b9b-5904-a8d3-ddde09adell3",
                        "status": "RECEIVED",
                        "amount": 100.0
                    }
                ]
            },
            "expired_at": "2023-12-05T22:00:00.000Z",
            "created_at": "2023-11-28T14:20:28.078Z",
            "updated_at": "2023-11-28T14:22:37.769Z"
        },

UNDERPAID and OVERPAID statuses are only possible if you get paid with manual transfers. In that case, be aware that you can have a REVOKED payment link with a PAID fund_information status.

Please check Reconcile manual transfer (via virtual IBAN) for more details about manual transfers.