Customer use cases

CUSTOMER=$(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": "user_84021",
    "email": "ada@example.com",
    "phoneNumber": "+2348012345678",
    "address": { "line1": "14 Marina Road", "city": "Lagos", "country": "NG" },
    "firstName": "Ada",
    "lastName": "Okafor"
  }')

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

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\"
  }"

async function ensureCustomer(reference: string, payload: object) {
  const created = await post('/v1/customers', { ...payload, externalReference: reference });
  if (created.status !== 409) return created.body;

  // Somebody — possibly a previous run of this job — already created them.
  const found = await get(`/v1/customers?externalReference=${encodeURIComponent(reference)}`);
  if (found.body.items.length === 1) return found.body.items[0];

  // A 409 with no match means an identity number collided, not the reference.
  throw new Error(`customer_already_exists but ${reference} is not on file`);
}

curl --request PATCH \
  --url "$SAKAWAVE_BASE_URL/v1/customers/$CUSTOMER_ID" \
  --header "Authorization: Bearer $SAKAWAVE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "email": "ada.okafor@example.com",
    "address": { "line1": "22 Awolowo Road", "city": "Lagos", "country": "NG" }
  }'

{
  "statusCode": 400,
  "message": "These fields do not apply to a individual customer: name.",
  "code": "customer_fields_do_not_match_type",
  "fields": ["name"]
}

GET /v1/customers?type=individual&jurisdiction:in=NG,GH&createdAt:gte=2026-08-01T00:00:00Z&sort=-createdAt&pageSize=50

SCAN_START=$(date -u +%Y-%m-%dT%H:%M:%SZ)
PAGE=1
while : ; do
  BODY=$(curl --silent --fail-with-body \
    --url "$SAKAWAVE_BASE_URL/v1/customers?pageSize=100&page=$PAGE&createdAt:lte=$SCAN_START" \
    --header "Authorization: Bearer $SAKAWAVE_API_KEY")
  printf '%s' "$BODY" | jq --compact-output '.items[]'
  [ "$(printf '%s' "$BODY" | jq --raw-output '.pagination.hasNext')" = "true" ] || break
  PAGE=$((PAGE + 1))
done

curl --request DELETE \
  --url "$SAKAWAVE_BASE_URL/v1/customers/$CUSTOMER_ID" \
  --header "Authorization: Bearer $SAKAWAVE_API_KEY"

{
  "statusCode": 409,
  "message": "Close this customer’s active wallets and terminate their cards before archiving the customer.",
  "code": "customer_has_active_products"
}