Skip to main content
Follow the steps below to send funds:
Make sure you have successfully created an entity and set up an account with its bank details
 To send money, you need a Counterparty
A Counterparty is the transfer recipient.

​
Create a Counterparty

Set up the recipient as a counterparty object using their account information. 
curl --location 'https://{BaseURL}/recipient-counterparties' \
--header 'Authorization: Bearer {{$NUVION_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "type": "individual",
    "entity_relationship": "customer",
    "name": "John F",
    "email": "[email protected]",
    "address": {
      "city": "Ojo",
      "state": "Lagos",
      "postal_code": "102101",
      "country_code": "NG",
      "line_1": "8 Mogaji"
    },
}'

​
Make Transfer

Create a new bank transfer using the counterparty’s ID. You’ll need to specify the account to debit and information like the amount in minor unit of the currency, currency and reference for the transfer. 
curl --location 'https://{baseURL}/bank-transfers' \
--header 'Authorization: Bearer {{$NUVION_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "currency": "USD",
    "amount": 10000,
    "account_id": "01KCGQZJNM1Z23BKQGVM9954VX",
    "narration": "Payment made",
    "counterparty_id": "01KCGJTZNANDFFKEF41MQMVKKZ",
    "unique_reference": "TRANS-REF-246810"
}'
Congratulations! You have made your first transfer.