# COP By Integrations

- [COP By Integrations](https://docs.copby.digitalcop.shop/index.md): Non-custodial API for Celo swaps and BRE-B COP payouts. Sign from the user wallet, then confirm onchain.
- [Quickstart](https://docs.copby.digitalcop.shop/quickstart.md): Preview these docs and hit the BRE-B quote endpoint (local or hosted).
- [Authentication](https://docs.copby.digitalcop.shop/authentication.md): How partners authenticate to the Integrations API.
- [Get a BRE-B quote](https://docs.copby.digitalcop.shop/api-reference/bre-b/get-a-bre-b-quote.md): Cached USD→COP rate (default 6 hours) plus the fee stack. Omit `destinationCop` to receive only the effective rate. Amounts below 4000 COP or 2 USDC to Bridge return `below_minimum`.
- [Get KYC status](https://docs.copby.digitalcop.shop/api-reference/bre-b/get-kyc-status.md)
- [Start KYC](https://docs.copby.digitalcop.shop/api-reference/bre-b/start-kyc.md): Returns `needs_otp` until the email is verified. Does not reveal whether the email already has an approved customer.
- [Send KYC email OTP](https://docs.copby.digitalcop.shop/api-reference/bre-b/send-kyc-email-otp.md)
- [Verify KYC email OTP](https://docs.copby.digitalcop.shop/api-reference/bre-b/verify-kyc-email-otp.md): After a valid code, mock mode auto-approves KYC. Live mode returns Persona `kycLink` and `tosLink` when the email is new.
- [List payouts for this integration](https://docs.copby.digitalcop.shop/api-reference/bre-b/list-payouts-for-this-integration.md)
- [Create a BRE-B payout](https://docs.copby.digitalcop.shop/api-reference/bre-b/create-a-bre-b-payout.md): Requires an approved customer. Creates a Bre-B external account and verifies name + key before returning the deposit transaction. `409 destination_mismatch` if verify does not match. `409 needs_kyc` if KYC is incomplete.
- [Get a payout](https://docs.copby.digitalcop.shop/api-reference/bre-b/get-a-payout.md)
- [Confirm a payout deposit](https://docs.copby.digitalcop.shop/api-reference/bre-b/confirm-a-payout-deposit.md): `txHash` is unique across payouts. A second payout cannot reuse it (`tx_hash_reused`). Mock mode skips the onchain receipt check.
- [Bridge webhook](https://docs.copby.digitalcop.shop/api-reference/webhooks/bridge-webhook.md): Bridge-only. Dedupes by `event_id`. `funds_received` updates the payout even if confirm never arrived.
- [Prepare a swap](https://docs.copby.digitalcop.shop/api-reference/swaps/prepare-a-swap.md)
- [Confirm a swap](https://docs.copby.digitalcop.shop/api-reference/swaps/confirm-a-swap.md)
- [List confirmed swaps](https://docs.copby.digitalcop.shop/api-reference/swaps/list-confirmed-swaps.md)

## OpenAPI Specs

- [openapi](/openapi.yaml)