Crear transferencia

POST 
/transfers

Creates an account-to-account transfer as a linked debit/credit pair sharing one transfer_id. Requires scope finance.transactions.write. The two accounts must differ, both must belong to the tenant, and both must have a linked company (cross-company is allowed). Pass an X-Idempotency-Key header on retries.

Solicitud

Respuestas

201

Transfer created. The Location header points at GET /transfers/{transfer_id}.

400

Malformed JSON body.

401

Missing / invalid / expired / revoked token.

403

Token lacks the finance.transactions.write scope.

404

A source/destination account was not found within the tenant.

409

X-Idempotency-Key reuse with a different body.

422

Schema validation failure, same source/destination account, non-positive amount, or an account without a linked company.

500

Unhandled server error.