Create a Checkout

POST

https://api.cobre.co/v1/checkouts

This API allows to create hosted checkout experience with payment links that can be shared with counterparties or payers, allowing them to pay directly into your specified account or Cobre balance.

See Checkout guide

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢201Creado

application/json

Example response

Body

🟠409Conflicto

🔴500Error interno del servidor

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.cobre.co/v1/checkouts' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "alias": "My first Checkout Link",
    "amount": 1000,
    "external_id": "external_id",
    "source_id": "cp_7TXCY43Mks",
    "destination_id": "acc_MGHbwJmZeu",
    "checkout_rails": [
        "pse",
        "bancolombia",
        "nequi",
        "breb"
    ],
    "checkout_header": "Checkout Header",
    "checkout_item": "Checkout Item",
    "description_to_payee": "Checkout Link",
    "valid_until": "2050-12-31T23:59:00Z",
    "money_movement_intent_limit": 1,
    "redirect_url": "https://www.cobre.com/"
}'

Response Example

201 - Checkout Response

{
    "id": "chk_0987654321",
    "alias": "My first Checkout Link",
    "geo": "col",
    "amount": 1000,
    "external_id": "external_id",
    "source_id": "cp_7TXCY43Mks",
    "destination_id": "acc_MGHbwJmZeu",
    "checkout_rails": [
        "pse",
        "bancolombia",
        "nequi",
        "breb"
    ],
    "checkout_header": "Checkout Header",
    "checkout_item": "Checkout Item",
    "valid_until": "2050-12-31T23:59:00Z",
    "money_movement_intent_limit": 1,
    "money_movement_created": 1,
    "redirect_url": "https://www.cobre.com/",
    "checkout_url": "https://links.cobre.co/KyQyQJ",
    "description_to_payee": "Checkout Link",
    "active": true,
    "created_at": "2025-03-27T21:28:07Z",
    "updated_at": "2025-03-27T21:28:07Z"
}

Modified at 2026-01-06 02:38:02

Obtain all the Cross Border Money Movements

Obtain one Checkout