Transfers represent movement of funds from one account to another. It can be intra bank (within Safe Haven) or NIP (which are just transfers to external banks).
Endpoints
| Method | Url |
|---|---|
GET | /transfers/banks |
POST | /transfers/name-enquiry |
POST | /transfers |
POST | /transfers/status |
GET | /transfers |
Flow
- Bank List: get the beneficiary's
bankCode. - Name Enquiry: confirm the account name. Keep the returned
sessionId. - Transfer: send that
sessionIdasnameEnquiryReference, with a uniquepaymentReference. - Transfer Status: check the final result using
sessionIdorpaymentReference, or wait for theoutward.transferwebhook.
Transfer statuses
| Status | Meaning |
|---|---|
Created | Accepted; final result not known yet. |
Processing | Being confirmed with NIBSS. |
Completed | Successful. |
Failed | Failed and the sender was not debited. No refund needed. |
Reversed | Failed after the sender was debited; the amount and fees were credited back (isReversed: true). |
Retrying
If a transfer times out or its status is unclear, check Transfer Status before you send it again. Never reuse a
paymentReference.