RAILS
Sandbox

Primeiro trilho em produção: Argentina

Trilhos de pagamento B2B para o seu sistema.

Contas de pagamento em pesos argentinos com CVU (número de conta virtual argentino), transferências imediatas pela COELSA (a câmara de compensação argentina), validação do titular, eventos e webhooks assinados. Uma API, um contrato estável.

Começar no sandboxVer a referência

Uma requisição assinada · 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"}

O que o Grip Rails faz

  • Contas em pesos com CVU

    Cada conta tem o seu saldo, lido do ledger no momento da requisição, e um ou mais CVU.

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

  • Transferências imediatas pela COELSA

    De saída para qualquer conta bancária (CBU), conta virtual (CVU) ou alias argentino, com autorização e reserva antes de movimentar um peso. De entrada, cada crédito lançado com o seu evento.

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

  • Validação do titular

    Antes de enviar, você confirma que o destino existe, está ativo e é de quem você espera.

    • POST/v1/counterparty_validations

  • Eventos e webhooks assinados

    Sequência contígua por entidade para conciliar sem lacunas. Webhooks assinados com JWS e chaves publicadas em JWKS.

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

  • Idempotência em todas as escritas

    Todo POST leva Idempotency-Key. Se a resposta se perder, você repete a mesma requisição com a mesma chave.

    • GET/v1/idempotency_keys/{key}

  • Sandbox com simulações

    Créditos recebidos, resultado do trilho e um relógio próprio para testar cada caminho sem dinheiro real.

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

Antes de escrever código

Valores
Inteiros em centavos de peso argentino: 150000 é ARS 1.500,00. A única moeda é ARS.
Autenticação
API key em Authorization: Bearer e uma assinatura HTTP (RFC 9421) de cada requisição com a sua chave privada Ed25519 ou P-256. A chave privada nunca sai do seu sistema.
Idempotência
Idempotency-Key obrigatória em todo POST. Nunca invente uma chave nova para tentar de novo.
Conciliação
GET /v1/events?after_sequence=N. A sequência é contígua por entidade: se você recebeu o 41 e depois o 43, falta o 42.
Erros
Um objeto error com type, code, message e retryable. Se retryable for true, repita a mesma requisição com a mesma chave.

Ambientes

AmbienteURL base
Produçãohttps://api.fcmpayments.comProdução. Dinheiro real; as transferências pela COELSA são irreversíveis. Habilitada por cliente.
Sandboxhttps://empresas-sandbox.fcmpayments.comSandbox. Ledger e trilho simulados; nunca movimenta dinheiro real.

Mais sobre sandbox e produção →

Por onde continuar