SPEI

The Payout using SPEI solution provides services to send funds from a Mexican bank account to external beneficiaries in Mexico using the SPEI real-time payments network.

SPEI Payouts are commonly used to disburse funds efficiently to bank accounts or debit cards, offering a fast, reliable, and widely adopted payout experience in Mexico.

Supported counterparties

PayOut via SPEI supports the following destination types in Mexico:

Destination Type	Counterparty Type	Rails
CLABE Account	`clabe`	SPEI
SPEI Card	`spei_card`	SPEI

Authorization Workflow (optional)

Checker Approval is an optional solution that can be used within the Payout flow. It triggers an authorization workflow before the transaction is sent to the payment network. While approval is pending, the Money Movement remains in a pending_approval status until it is either approved or rejected. The approval process can be completed either through the Cobre Portal or programmatically via API.

Payout lifecycle

A PayOut through SPEI follows a simple lifecycle:

1. Create a Counterparty (beneficiary)
Create a Counterparty with the beneficiary’s information.
This counterparty represents the destination of the SPEI Payout transaction.

2. Create a Money Movement
Create a Money Movement using:

The account_id from which the funds will be debited, used as the source_id.

The counterparty_id from the previous step as the destination_id

The metadata with a description and reference

The external_id where you can use to send a reference from your system.

The amount provided in the smallest unit of the currency (e.g., 100.00 MXN should be represented as 10000).

The checker_approval as true if you want use our authorization flow.

3. Money Movement is processed
Once created, the Money Movement starts in the initiated status.

If all validations pass, the status changes to processing. At this point, the transaction is sent through SPEI

If an error occurs during validation or processing, the Money Movement transitions to the final failed status.

If the Money Movement is created with checker_approval = true, it first moves to the pending_approval status and will only transition to processing or canceled once the approval decision is made.

4. Funds are debited
Once the Money Movement transitions to the processing status, the funds are debited from the associated Cobre Balance.

5. Wait for the final outcome of the Money Movement.

If the Money Movement is completed, the beneficiary has successfully received the funds.

If the Money Movement is rejected, the funds are credited back to your Cobre Balance.

6. Receive status updates
Money Movement status changes are communicated via Webhooks.

Actions performed on a Money Movement (Payout)

🔑 Create

🔍 Retrieval

Description: Money Movement Creation.
What to expect after the action: Money Movement is created in Cobre.
📘 Learn more:

🔗 Create a Money Movement

Money Movement Idempotency

Money Movement creation supports idempotency.

Idempotency keys are valid for 24 hours.

How to Get Started

Before you begin, we recommend reviewing the following considerations.

Before using this API

You need a Cobre Balance in Mexico

To send funds using SPEI, you must have an active Cobre Balance account in Mexico with enough funds.

Create the beneficiary Counterparty

Before creating a Payout Money Movement, you must create a Counterparty with the beneficiary’s information, matching the selected destination type.

Define the Payout configuration

Decide the destination type, amount, and any required metadata needed to process the Payout.

Implement Webhooks to track payment status

To stay informed about the status of Payout transactions, we strongly recommend implementing Webhooks. Webhooks notify your system when a payment is initiated, processed, completed, or failed. Also subscribe to the required events to receive notifications about transaction debits and credits.

See Notifications for more details.

What to expect after using this API

Initiate the Payout

Once the Money Movement creation request is sent, it will be created with an initiated status.
Make sure your system is prepared to receive status updates as the Money Movement progresses through its lifecycle.

Track the transaction status

Monitor the Payout lifecycle using Webhooks or retrieval endpoints.

Funds are delivered to the beneficiary

When the Payout is successful, funds are credited to the beneficiary’s account and the Money Movement status is updated accordingly.

SPEI

Supported counterparties#

Authorization Workflow (optional)#

Payout lifecycle#

Actions performed on a Money Movement (Payout)#

Money Movement Idempotency#

How to Get Started#

Before using this API#

What to expect after using this API#