Return a Money Movement

The Money Movement Return API allows you to return any given credit transaction within the supported providers and transaction types.

Allowed return combinations

The following table contains the allowed transaction types and providers where you can return a transaction.

Country	Allowed Transaction type	Account provider id
Mex	spei_credit	pr_mex_cobre2
Mex	spei_credit	pr_mex_cobre3
Mex	spei_credit	pr_mex_cobre (🚧 Coming soon)
Mex	spei_credit	pr_mex_072 (🚧 Coming soon)
Mex	spei_credit	pr_mex_014 (🚧 Coming soon)
Mex	spei_credit	pr_mex_012 (🚧 Coming soon)

Returning a SPEI credit

Returning a SPEI credit transaction is as easy as:

Locate the transaction you want to return by finding its transaction_id (either from a cobre balance or connect). This transaction should have one of the valid combinations mentioned above.

Use the Money Movements Return API endpoint and provide the following parameters:

transaction_id: The ID of the transaction you wish to return.

metadata: Metadata associated with the return, which will depend on the type of transaction being returned.

After successfully initiating the return:

A new money movement will be created, associtiated with the type spei_return.

A new counterparty will be created, associtiated with the type mm_return.

The corresponding debit transaction spei_debit will be reflected on the cobre balance or connect account.

Keep in mind that it is not possible to perform spei_return money movements between pr_mex_cobre3 accounts.

This type of money movement is not compatible with the Account Linkeage funtionality

See Money Movement guide

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://api.cobre.co/v1/money_movements_return' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "transaction_id": "trx_1232145215", "metadata": { "description": "Returned transaction" } }'

{ "id": "mm_123456789012", "batch_id": "", "external_id": "trx_1232145215", "mm_approval_id": "", "creator": "usr_bGcdf26rR4", "type": "spei_return", "geo": "mex", "status": { "state": "initiated", "code": "string", "description": "string" }, "source_id": "acc_KJnAkypWSc", "source": {}, "destination_id": "cp_012345678910", "destination": {}, "currency": "mxn", "amount": 5000, "metadata": { "description": "Returned Transaction", "tracking_key": "20240624mmbgu7gkQwofrb9o", "reference": "0123456", "cep_url": "https://cep.banco.com/download" }, "created_at": "2024-06-24T15:37:37Z", "updated_at": "2024-06-24T15:37:38Z", "checker_approval": false }

Return a Money Movement

Allowed return combinations

Returning a SPEI credit

Request

Responses

Return a Money Movement

Allowed return combinations#

Returning a SPEI credit#

Request

Responses

Allowed return combinations

Returning a SPEI credit