curl --request POST \
--url 'https://api.stateset.com/api/v1/store-credits' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"amount": "49.00",
"currency": "USD",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"note": "Two-person tent, green — replacement for damaged pole set.",
"reason": "Two-person tent, green — replacement for damaged pole set."
}'
{
"created_at": "2026-08-31T14:22:05Z",
"currency": "USD",
"current_balance": "49.00",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"original_balance": "49.00",
"reason": "Two-person tent, green — replacement for damaged pole set.",
"status": "pending"
}
Create a store credit
Create a store credit
POST
/
api
/
v1
/
store-credits
curl --request POST \
--url 'https://api.stateset.com/api/v1/store-credits' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"amount": "49.00",
"currency": "USD",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"note": "Two-person tent, green — replacement for damaged pole set.",
"reason": "Two-person tent, green — replacement for damaged pole set."
}'
{
"created_at": "2026-08-31T14:22:05Z",
"currency": "USD",
"current_balance": "49.00",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"original_balance": "49.00",
"reason": "Two-person tent, green — replacement for damaged pole set.",
"status": "pending"
}
Request body
CreateStoreCreditRequest
string
required
string,null
string (uuid)
required
string,null
string,null
Response
StoreCreditResponse
string
required
string
required
string
required
string
required
string
required
string
required
string
required
string
required
Status codes
| Code | Meaning |
|---|---|
201 | — |
400 | — |
curl --request POST \
--url 'https://api.stateset.com/api/v1/store-credits' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"amount": "49.00",
"currency": "USD",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"note": "Two-person tent, green — replacement for damaged pole set.",
"reason": "Two-person tent, green — replacement for damaged pole set."
}'
{
"created_at": "2026-08-31T14:22:05Z",
"currency": "USD",
"current_balance": "49.00",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"original_balance": "49.00",
"reason": "Two-person tent, green — replacement for damaged pole set.",
"status": "pending"
}
Last modified on August 31, 2026