Recaudo Docs
Crear cuenta

Pagos y clientes

Cargos

Haz cargos directos a métodos de pago guardados. Ideal para cargos recurrentes o pagos en un clic.

POST /v1/charges

Crear cargo

Hace un cargo a un método de pago guardado.

Parámetros

Parámetro Tipo Requerido Descripción
amount number Sí Monto en decimales (p. ej. 100.00 = $100.00)
currency string Sí Código ISO de moneda
payment_method string Condicional* ID del método de pago guardado
token string Condicional* Token de tarjeta generado con recaudo.js (tok_xxx para Conekta, pm_xxx para Stripe)
card object No Info de tarjeta de recaudo.js: { brand, last4, exp_month, exp_year }. Recomendado para mejor seguimiento
customer string Condicional* ID del cliente (requerido si usa payment_method)
description string No Descripción del cargo
Petición 
curl -X POST https://recaudo.app/api/v1/charges \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 250.00,
    "currency": "MXN",
    "token": "tok_abc123...",
    "card": {
      "brand": "visa",
      "last4": "4242",
      "exp_month": 12,
      "exp_year": 2027
    },
    "description": "Cargo por servicio premium"
  }'
Respuesta 201 
{
  "id": "8d8f4fa9-cbab-4913-93b1-38bdc9999eb8",
  "object": "charge",
  "amount": 250.00,
  "currency": "MXN",
  "status": "succeeded",
  "customer_id": "8e250c25-9d84-4892-98ec-d71fc1fcd3c7",
  "payment_method_id": "pm_card_xyz123",
  "description": "Cargo por servicio premium",
  "payment_intent_id": "pi_789xyz",
  "receipt_url": "https://recaudo.app/receipt/8d8f4fa9-cbab-4913-93b1-38bdc9999eb8",
  "created_at": "2024-01-15T10:30:00Z"
}
POST /v1/charges/:id/refund

Reembolsar cargo

Hace un reembolso total o parcial de un cargo.

Petición (reembolso parcial) 
curl -X POST https://recaudo.app/api/v1/charges/8d8f4fa9-cbab-4913-93b1-38bdc9999eb8/refund \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00,
    "reason": "customer_request"
  }'
Respuesta 200 
{
  "id": "re_xyz789abc",
  "object": "refund",
  "amount": 100.00,
  "currency": "MXN",
  "charge_id": "8d8f4fa9-cbab-4913-93b1-38bdc9999eb8",
  "status": "succeeded",
  "reason": "customer_request",
  "created_at": "2024-01-15T11:00:00Z"
}
¿Te sirvió esta página? Gracias por avisarnos.
Esc