Transfers

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

Flow

  1. Bank List: get the beneficiary's bankCode.
  2. Name Enquiry: confirm the account name. Keep the returned sessionId.
  3. Transfer: send that sessionId as nameEnquiryReference, with a unique paymentReference.
  4. Transfer Status: check the final result using sessionId or paymentReference, or wait for the outward.transfer webhook.

Transfer statuses

StatusMeaning
CreatedAccepted; final result not known yet.
ProcessingBeing confirmed with NIBSS.
CompletedSuccessful.
FailedFailed and the sender was not debited. No refund needed.
ReversedFailed 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.