Customers

Grant credits to a customer

Adds credits to a customer balance. Use Idempotency-Key to make grants safe to retry.

post/v1/sdk/customers/{reference}/credits

Request

Base URL
https://api.solvapay.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/solvapay/apis/solvapay-rest-api/docs/v1/sdk/customers/:reference/credits/post.ts
A function with typed inputs. Its response is checked against the schema.

referencestring required

Example:cus_3c4d5e6f7g8h

Customer reference identifier

Idempotency-Keystring

Provider-scoped idempotency key for safe grant retries

creditsinteger required

reasonstring

Credits granted successfully

balancenumber required

Customer credit balance after the grant

creditsnumber required

Granted credit amount

customerRefstring required

Customer reference identifier

reasonstring

Machine-readable grant reason

successboolean required

Whether the grant was recorded

Jul 17, 2026bbc2ff2bc849 Revision changes
- breaking
  added the pattern ^[\p{L}\p{N}\s.,'"&\/()+:%;?!@#_[\]\-]*$ to the request property
Jul 4, 2026a30b6aef464d Revision changes
- info
  endpoint added