La plataforma de Cobre expone sus productos de pago a través de un conjunto de APIs. Estos productos son accesibles mediante endpoints sencillos, ofreciendo a los clientes funcionalidad de pago sin complicaciones operativas. Cobre maneja las complejidades del procesamiento de pagos, liberando a los clientes de las complejidades de las operaciones de movimiento de dinero.Fechas y Fechas/Horas (UTC): Dominando las Zonas Horarias#
Cobre utiliza la zona horaria universal UTC para todos los campos de fecha y fecha/hora dentro de nuestra plataforma, ofreciendo una experiencia unificada del tiempo. Este enfoque asegura que independientemente de dónde estén ubicados nuestros clientes, el tiempo de las transacciones y operaciones se mantenga consistente y sincronizado.Ejemplos#
Timestamp UTC: "2023-07-15T12:00:00Z"En Colombia (UTC-5), este timestamp se traduce al 15 de julio de 2023, a las 7:00 AM.
En Ciudad de México (UTC-6 durante Horario Estándar), esto representa el 15 de julio de 2023, a las 6:00 AM.
Timestamp UTC: "2023-11-10T18:30:00Z"En Colombia (UTC-5), esto corresponde al 10 de noviembre de 2023, a la 1:30 PM.
En Ciudad de México (UTC-6 durante Horario Estándar), esto significa el 10 de noviembre de 2023, a las 12:30 PM o 1:30 PM dependiendo del horario de verano.
Detalles de Paginación#
Comprender la estructura de nuestras respuestas de API es clave para navegar y utilizar Cobre Platform de manera efectiva. Aquí tienes un desglose de nuestro sistema de paginación:total_items (number): El número total de elementos devueltos por la API.
total_pages (number): El número de páginas dado el tamaño de página actual.
is_last_page (boolean): Un indicador verdadero/falso que muestra si la página actual es la última página. Por defecto: false.
page_items (number): El número de elementos en la página actual. Por defecto: 50.
page_size (number): Puedes establecer el número máximo de elementos en una página.
page_number (number): Puedes seleccionar la página.
contents (array): Un arreglo que contiene los elementos de la página actual.
Ten en cuenta que no es posible paginar más de 10,000 registros.
Convenciones de la API#
Idempotencia#
Las solicitudes POST de money movement y cross border money movement requieren un encabezado idempotency para evitar operaciones duplicadas al reintentar. Si se recibe la misma clave nuevamente, Cobre devuelve la respuesta original sin volver a ejecutar la operación.| Regla | Detalle |
|---|
| Requerido en | /v1/money_movements, /v1/cross_border_money_movements |
| Método | POST |
| Longitud mínima | 9 caracteres |
| Encabezado faltante | Devuelve HTTP 400 |
Montos#
Todas las cantidades monetarias en la API de Cobre se expresan en la unidad monetaria más pequeña de la moneda (unidades menores).| Moneda | Unidad más pequeña | Cantidad | Valor de la API |
|---|
| COP | centavos | $1.500,20 COP | 150020 |
| MXN | centavos | $2.390,15 MXN | 239015 |
| USD | centavos | $1.52 USD | 152 |
Esto se aplica de forma consistente a todos los endpoints — movimientos de dinero, balances, transacciones y cotizaciones de divisas.Aunque la documentación de la API representa amount como un integer, el campo se maneja internamente como int64, admitiendo valores de hasta 9,223,372,036,854,775,807
