RAILS
Sandbox

Primer riel en producción: Argentina

Rieles de pago B2B para tu sistema.

Cuentas de pago en pesos con CVU, transferencias inmediatas por COELSA, validación del titular, eventos y webhooks firmados. Una API, un contrato estable.

Empezar en el sandboxVer la referencia

Un pedido firmado · sandbox
POST /v1/outgoing_transfers HTTP/1.1
Host: empresas-sandbox.fcmpayments.com
Authorization: Bearer fcm_test_…
Content-Type: application/json
Idempotency-Key: 7c1d9a54-…
Content-Digest: sha-256=:…:
Signature-Input: sig1=("@method" "@target-uri" "content-type"
  "content-digest" "idempotency-key");created=…;nonce="…";keyid="ck_…";alg="ed25519"
Signature: sig1=:…:

{"account_id":"acc_…","amount":100000,"currency":"ARS",
 "destination":{"type":"alias","value":"sbx.valida"},
 "expected_counterparty_cuit":"27000000006"}

Qué hace Grip Rails

  • Cuentas en pesos con CVU

    Cada cuenta tiene su saldo, leído del libro en el momento del pedido, y uno o más CVU.

    • GET/v1/accounts
    • GET/v1/account_numbers

  • Transferencias inmediatas por COELSA

    De salida a CBU, CVU o alias, con autorización y reserva antes de mover un peso. De entrada, cada crédito asentado con su evento.

    • POST/v1/outgoing_transfers
    • GET/v1/incoming_transfers

  • Validación del titular

    Antes de enviar, confirmás que el destino existe, está activo y es de quien esperás.

    • POST/v1/counterparty_validations

  • Eventos y webhooks firmados

    Secuencia contigua por entidad para conciliar sin huecos. Webhooks firmados con JWS y claves publicadas en JWKS.

    • GET/v1/events
    • GET/.well-known/jwks.json

  • Idempotencia en todas las escrituras

    Todo POST lleva Idempotency-Key. Si se pierde la respuesta, repetís el mismo pedido con la misma clave.

    • GET/v1/idempotency_keys/{key}

  • Sandbox con simulaciones

    Créditos entrantes, resultado del riel y un reloj propio para probar cada camino sin dinero real.

    • POST/v1/simulations/incoming_transfers
    • POST/v1/simulations/clock/advance

Antes de escribir código

Montos
Enteros en centavos de peso: 150000 es $ 1.500,00. La única moneda es ARS.
Autenticación
API key en Authorization: Bearer y una firma HTTP (RFC 9421) de cada pedido con tu clave privada Ed25519 o P-256. La clave privada nunca sale de tu sistema.
Idempotencia
Idempotency-Key obligatoria en todo POST. Nunca inventes una clave nueva para reintentar.
Conciliación
GET /v1/events?after_sequence=N. La secuencia es contigua por entidad: si recibiste el 41 y después el 43, te falta el 42.
Errores
Un objeto error con type, code, message y retryable. Si retryable es true, repetí el mismo pedido con la misma clave.

Entornos

EntornoURL base
Producciónhttps://api.fcmpayments.comProducción. Dinero real; las transferencias por COELSA son irreversibles. Se habilita por cliente.
Sandboxhttps://empresas-sandbox.fcmpayments.comSandbox. Libro y riel simulados; nunca mueve dinero real.

Más sobre sandbox y producción →

Por dónde seguir