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

# Collections overview

> Understanding collections and how to attach customers to transactions

Collections can be triggered by external payment flows such as Interac, virtual bank accounts, and API card collections.

After receiving a confirmed collection webhook, you can attach a verified customer to the collection when the collection type supports post-creation customer assignment.

<Note>
  For CAD collections, you must have added an Interac email (e.g. `support@blaaiz.com`) via the Blaaiz dashboard. Without this, funds will not reflect in your wallet.
</Note>

## Attach a customer to the collection

Once a collection transaction is confirmed, you'll need to associate it with a customer.

* **Endpoint**: `/collection/attach-customer`
* **Request**: Provide the `customer_id` and `transaction_id` to associate a customer with the collection transaction.
* **Customer requirement**: The customer must belong to your business and must be `VERIFIED`. Both `type=individual` (verified through KYC) and `type=business` (verified through the [KYB flow](/guides/kyb/overview)) are accepted.
* **Purpose**: This links the collection to a customer for attribution and downstream processing.

<Warning>
  API card collections must be created with `customer_id` up front. They cannot be updated later with `/collection/attach-customer`.
</Warning>

## Webhooks

Collection events are sent to your configured `collection_url`.

* Successful collection notifications let you reconcile inbound payments.
* Customer KYC events such as `customer.created`, `customer.verified`, and `customer.rejected` also go to `collection_url`.
* Virtual account events are also delivered to `collection_url`.

See [Webhook events and payloads](/guides/webhooks/events) for the event list and [Register webhook URLs](/api-reference/webhook/register) for configuration.

## Related endpoints

* [Initiate collection](/api-reference/collection/create) - initiate API card collections.
* [Attach customer to collection](/api-reference/collection/attach-customer) - associate a supported collection with a verified customer.
* [Accept Interac money request](/api-reference/collection/accept-interac) - accept an incoming Interac transfer into your wallet.
* [Initiate Interac money request](/api-reference/collection/initiate-interac) - request CAD from a payer's email; funds settle when they approve.