POST
/
v1
/
payments
/
customers
curl https://api.geldstuck.com/v1/payments/customers \
  -H "x-api-key: $GELDSTUCK_PUBLIC_KEY" \
  -H "x-api-secret: $GELDSTUCK_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"userId": "usr_01HX3ZAB...", "email": "ada@example.com"}'

{
  "id": "cus_01HX3ZR...",
  "userId": "usr_01HX3ZAB...",
  "email": "ada@example.com",
  "createdAt": "2026-04-22T13:30:00.000Z"
}

​
Body

​
userId
string
required
​
email
string
required
​
name
string

​
Returns

​
id
string
Customer ID (cus_...).
curl https://api.geldstuck.com/v1/payments/customers \
  -H "x-api-key: $GELDSTUCK_PUBLIC_KEY" \
  -H "x-api-secret: $GELDSTUCK_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"userId": "usr_01HX3ZAB...", "email": "ada@example.com"}'

{
  "id": "cus_01HX3ZR...",
  "userId": "usr_01HX3ZAB...",
  "email": "ada@example.com",
  "createdAt": "2026-04-22T13:30:00.000Z"
}