> ## Documentation Index
> Fetch the complete documentation index at: https://docs.broco.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Supplier payments overview

> Pay suppliers from your Broco balance and reconcile each payment with an invoice.

Supplier payments let a business pay a supplier from its Broco balance. The supplier has a Broco account. The payment is a transfer between the two Broco accounts, approved by an authorized user of the business and linked to an invoice reference.

## How a supplier payment works

```mermaid theme={null}
flowchart TD

  A["Software prepares the payment<br/>status: awaiting_approval"]:::step --> B["Authorized user approves in Broco"]:::check
  B --> C["Broco debits the business<br/>and credits the supplier<br/>status: succeeded"]:::money
  C -.-> D["supplier_payment.succeeded<br/>sent to the software"]:::notify
  D --> E["Software marks the invoice as paid"]:::step
  B -. "rejects" .-> R["status: rejected"]:::step
  classDef money fill:#158FAB,stroke:#0E6F86,color:#FFFFFF
  classDef check fill:#E8F4F7,stroke:#158FAB,color:#0E1C29
  classDef notify fill:#FFF6C2,stroke:#B89400,color:#0E1C29,stroke-dasharray:4 3
  classDef step fill:#FFFFFF,stroke:#C9D0D6,color:#0E1C29
```

In this diagram, blue steps move money, light blue steps are validations, and dashed yellow steps are notifications.

<Steps>
  <Step title="The business connects its accounting or ordering software">
    An administrator of the business authorizes the software to prepare supplier payments on its Broco account.
  </Step>

  <Step title="The supplier is an authorized beneficiary">
    The business adds the supplier to its beneficiaries in Broco. Broco shows the verified name of the supplier's account.
  </Step>

  <Step title="The software prepares the payment">
    The software sends the beneficiary, the amount, the currency and the invoice reference. The payment waits for approval.
  </Step>

  <Step title="An authorized user approves">
    A user with approval rights reviews the supplier, the amount and the invoice in Broco, then approves or rejects.
  </Step>

  <Step title="Broco transfers the funds">
    Broco debits the business balance and credits the supplier's balance. The software receives `supplier_payment.succeeded`.
  </Step>

  <Step title="Both parties reconcile">
    The business and the supplier see the payment with the invoice reference in their Broco history.
  </Step>
</Steps>

<Info>
  The software's credentials identify the integration. They do not authorize spending: every payment needs the approval of an authorized user of the business.
</Info>

## Scope

Supplier payments move funds between two Broco accounts, in the currency of the payment. They do not cover bank transfers, currency exchange, credit, invoice financing, direct debits or international payouts.

## When a payment does not go through

| Situation | Result | Money moved |
| - | - | - |
| The approver rejects the payment | `rejected` | No |
| The business balance is too low at approval | `declined`, reason `insufficient_balance` | No |
| The beneficiary is not an authorized beneficiary | Request refused with `beneficiary_not_authorized` | No |
| No approval before the deadline | `expired` | No |
| The software times out and retries with the same key | The first payment is returned | Once |

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" href="/supplier-payments/quickstart">
    Pay a 320 000 DZD invoice step by step.
  </Card>

  <Card title="Supplier payments API" href="/api-reference/supplier-payments">
    Fields, statuses and examples.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.