Create a customer and account - Sakawave API

This tutorial creates two resources. Persist each returned ID; resource IDs are opaque and should not be reconstructed.

Create the customer

CUSTOMER_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --request POST \
  --url "$SAKAWAVE_BASE_URL/v1/customers" \
  --header "Authorization: Bearer $SAKAWAVE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "type": "individual",
    "jurisdiction": "NG",
    "externalReference": "customer_tutorial_001",
    "email": "ada@example.com",
    "phoneNumber": "+2348012345678",
    "address": {
      "line1": "14 Marina Road",
      "city": "Lagos",
      "state": "Lagos",
      "country": "NG"
    },
    "firstName": "Ada",
    "lastName": "Okafor"
  }')

CUSTOMER_ID=$(printf '%s' "$CUSTOMER_RESPONSE" | jq --raw-output '.id')

The response does not echo identity numbers. It exposes fields such as hasBvn and hasNin instead.

Open the wallet account

curl --request POST \
  --url "$SAKAWAVE_BASE_URL/v1/accounts" \
  --header "Authorization: Bearer $SAKAWAVE_API_KEY" \
  --header "Content-Type: application/json" \
  --data "{
    \"name\": \"Ada NGN wallet\",
    \"type\": \"operational\",
    \"currency\": \"NGN\",
    \"customerId\": \"$CUSTOMER_ID\",
    \"metadata\": { \"origin\": \"sandbox-tutorial\" }
  }"

Supplying customerId makes the account a customer wallet. Omitting it opens an account owned directly by your business. Only two types are client-selectable — operational and savings — and they behave identically. A customer wallet can only be NGN; see currencies and funding rails.

Store the returned account id for transfers. Use balance, the minor-unit string, for arithmetic—not balanceFormatted.