Add balancePOST

OpenStock Docs

POST

/api/customer-balance-api/customers/add-balance

customer_balance_api100 requests / hour

Credits a customer’s store balance. Customers that do not exist yet are created.

Authorization#

AuthorizationBearer <token>

In: header. A store API key starting with sk_ that has the customer_balance_api permission.

Request body#

application/json

emailrequiredstring

Customer email address.

amountrequirednumber

Positive amount to add.

reasonstring

Shown in the customer’s transaction history. Default: "API balance addition"

metadataobject

Stored with the transaction.

Responses#

200Balance updated.
400Invalid email or amount.
409The balance changed while updating. Retry the request.
401Missing, malformed, disabled or expired API key.
429The hourly limit for this key was reached.

curl -X POST "https://openstock.dev/api/customer-balance-api/customers/add-balance" \
  -H "Authorization: Bearer $OPENSTOCK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "jane@example.com",
    "amount": 10,
    "reason": "Referral reward"
  }'

Balance updated.

{
  "success": true,
  "customer": {
    "id": "6f1d3c2a-0b4e-4c8d-9a7f-2e5b1c0d9a8e",
    "email": "jane@example.com",
    "balance": 35
  },
  "transaction": {
    "type": "credit",
    "amount": 10,
    "reason": "Referral reward"
  }
}