Movimientos
Usa el historial de movimientos para conciliación, tesorería y soporte.
El contrato de movimientos de Cobru sigue viniendo de materiales legacy. La forma de la ruta es prometedora, pero parámetros y respuesta necesitan una nueva validación antes de usarlos para contabilidad automatizada.
Por qué importa esta guía
El historial de movimientos es una necesidad operativa recurrente en pagos, envíos, retiros y tarjetas.
Patrón de endpoint
GET /movements/movements_by_types/?{type_req}=true&per_page={number}&page_num={number}
Valores type_req descritos en Spotlight:
by_cobrusby_withdrawsby_sendsby_other_payments
Debes enviar un solo filtro por request.
Ejemplo de request
curl -G https://dev.cobru.co/movements/movements_by_types/ \
-H "x-api-key: $COBRU_API_KEY" \
-H "Authorization: Bearer $COBRU_ACCESS_TOKEN" \
--data-urlencode "by_cobrus=true" \
--data-urlencode "per_page=10" \
--data-urlencode "page_num=1"const url = new URL('https://dev.cobru.co/movements/movements_by_types/');
url.searchParams.set('by_cobrus', 'true');
url.searchParams.set('per_page', '10');
url.searchParams.set('page_num', '1');
const response = await fetch(url, {
headers: {
'x-api-key': process.env.COBRU_API_KEY!,
Authorization: `Bearer ${accessToken}`,
},
});
const movements = await response.json();
console.log(movements);import requests
response = requests.get(
"https://dev.cobru.co/movements/movements_by_types/",
headers={
"x-api-key": COBRU_API_KEY,
"Authorization": f"Bearer {access_token}",
},
params={
"by_cobrus": "true",
"per_page": 10,
"page_num": 1,
},
)
print(response.json())<?php
use GuzzleHttp\Client;
$client = new Client();
$response = $client->request('GET', 'https://dev.cobru.co/movements/movements_by_types/', [
'headers' => [
'x-api-key' => getenv('COBRU_API_KEY'),
'Authorization' => 'Bearer ' . $accessToken,
],
'query' => [
'by_cobrus' => 'true',
'per_page' => 10,
'page_num' => 1,
],
]);
$movements = json_decode((string) $response->getBody(), true, 512, JSON_THROW_ON_ERROR);
var_dump($movements);Checklist de conciliación
Persiste primero los payloads de webhook de Cobru y procésalos de forma asíncrona.
Conciliá una fila de movimiento con identificadores de pago o retiro, no solo por monto.
Recorre histórico cuando un webhook falle, llegue tarde o deje un estado ambiguo.