Skip to main content
The obvious API design would let a transfer take an account number. Sakawave does not, and the reason shapes everything in this service.

​
Why a destination exists

An account number is a claim. A destination is a checked claim, with a timestamp on it. Creating a destination is where the work happens:
  1. The destination currency is checked against the capability for this kind of transfer.
  2. The route is confirmed to serve the country.
  3. The route’s required fields are confirmed present.
  4. Where the rail supports it, the account is looked up with the provider and the real account name comes back.
  5. The counterparty profile the payout rail needs is confirmed complete.
By the time you hold a destinationId, five things that could have failed have not. The transfer itself is then a small, fast operation — which matters when it is moving money. The 24-hour expiry follows from the same logic. A verification is only as good as the moment it was made; an account closed yesterday should not be payable today on the strength of last week’s lookup.

​
Inline or saved

Both paths end at the same object. Choose on whether you will pay this person again. The second-to-last row is the one that decides it for most integrations. With saved recipients, the routing values live encrypted at Sakawave and you never handle them again. Inline, you must keep them somewhere to send them next time — and that somewhere is now in scope for your own compliance.

​
When a recipient is not the answer

  • Paying your own account. Use an own_account destination.
  • Paying another Sakawave account. Use a sakawave_tag destination — including your own customers’ wallets, which own-account destinations exclude.
  • A one-off you will never repeat. Inline is fewer calls and leaves nothing behind.

​
Recipients are not customers

Both hold names and addresses; they are opposite ends of the money. Nothing stops the same human being both. They are separate records with separate lifecycles, and Sakawave will not link them for you.

​
The shape of the API

Eleven operations, all rate-limited together at 120 per minute. There is no endpoint to update a recipient or a payment detail. Both are create-and-delete: to correct an account number, add a new detail and delete the old one.