Skip to content
Testnet only: a reference implementation, not a production service.Tokens and bank transfers here are simulated and have no value.

Simulate a wire in the sandbox

This page runs in CI against an in-process core on FakeChain. If an example here stops working, the build fails.

First, create a bank-account counterparty. The {{KEY}} placeholder is your Testnet API key and {{uuid}} is a fresh idempotency key.

POST /v1/counterparties
authorization: Bearer {{KEY}}
idempotency-key: {{uuid}}
content-type: application/json

{
  "type": "bank_account",
  "label": "Ops account",
  "beneficiary_name": "Acme Testnet Ltd",
  "bank_name": "Testnet mock bank",
  "account_number": "GB00TEST12345678",
  "routing_code": "TEST0001",
  "currency": "USD"
}
# expect 201
# save COUNTERPARTY_ID = $.id

Then simulate a wire with POST /v1/sandbox/fiat-deposits. This example uses the counterparty id as the reference. Nothing matches that reference, so the wire is held in suspense. To see a credited wire, use the deposit_instructions.reference of a mint transfer.

POST /v1/sandbox/fiat-deposits
authorization: Bearer {{KEY}}
idempotency-key: {{uuid}}
content-type: application/json

{
  "reference": "{{COUNTERPARTY_ID}}",
  "amount": "250.00",
  "currency": "USD"
}
# expect 201

Edit on GitHub