Sandbox Simulations

Simulate Outgoing Transfer

Due to the complexity of international wire transfers, various errors may occur resulting in failed or returned transfers. You can simulate those errors during development in our Sandbox.

You can simulate various transfer failures at different stages of outgoing transfer requests. To trigger a transfer failure, set message_to_beneficiary_bank in your request with these special values:

request-invalid - request rejected by the SWIFT network during validation: invalid BIC, invalid IBAN, etc.
request-delivery-failed - request rejected by the SWIFT network during delivery: SWIFT system issues, aborted, etc.
request-delivery-delayed - request delayed by the SWIFT network, but it is finally delivered successfully
request-returned-by-correspondent-bank - request returned by our correspondent bank due to invalid FX contract, missing required country-specific information, etc.
request-returned-by-beneficiary-bank - request returned by the beneficiary bank due to invalid beneficiary data, invalid account numbers, etc. The system deducts USD 10.00 from the transfer amount to simulate return charges. If the transfer amount is less than USD 10.00, no return charge will be deducted.

Any other values for message_to_beneficiary_bank result in normal settlement flows for outgoing transfers.

curl https://api.column.com/transfers/international-wire \
  -XPOST \
  -u :<YOUR API KEY> \
  -d amount=100000 \
  -d currency_code=CNY \
  -d bank_account_id=bacc_xxx \
  -d counterparty_id=cpty_xxx \
  -d description="test transfer failure" \
  -d "remittance_info[general_info]"="Invoice ID 123" \
  -d message_to_beneficiary_bank="request-returned-by-correspondent-bank"

Simulate Incoming Transfers

You can also simulate incoming international wires in our Sandbox.

curl https://api.column.com/simulate/receive-international-wire \
  -XPOST \
  -u :<YOUR API KEY> \
  -d destination_account_number_id=acno_xxx \
  -d amount=100000 \
  -d currency_code=CNY