International transfers

Use international transfers to send funds to external accounts. You can send funds either to a traditional bank account (global bank account recipient) or to a mobile money account (global mobile money recipient).

Unlike external transfers, recipients get the funds in their local currency, regardless of the currency sent. For example, if you transfer USD to a Nigerian bank account, the recipient receives it in naira.

Add a global bank account recipient or Add a global mobile money recipientbefore you initiate the transfer request. Then include the sender’s account id, customer id, and the recipient’s external account id in your request.

The source object contains the sender’s details, and the destination object contains the recipient’s details. Also, your transfer can be ACH or Wire transfer:

curl --request POST \
     --url https://api.gravv.xyz/v1/transfer \
     --header 'Api-Key: <Api Key>' \
     --header 'Idempotency-Key: 979879887678789_attempt_1' \
     --header 'content-type: application/json' \
     --data '
{
  "source": {
    "source_type": "internal_account",
    "id": "b9c2cb0d-e09a-496f-8655-d8c4b7aaf2f8"
  },
  "destination": {
    "destination_type": "external_account",
    "id": "74943275-6874-41b4-bd71-13d6cf5ed802",
    "rail": "wire"
  },
  "amount": 1.5,
  "client_reference": "099283849s",
  "description": "Transfer Testing",
  "customer_id": "bb6c6022-f1d8-492f-80f0-7547134bb42f"
}
'