cURL
curl -X PATCH "https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/customers/{customerKey}/balance" \
-H "Authorization: Bearer $JOIN_MARKT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"add","amount":1}'const res = await fetch("https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/customers/{customerKey}/balance", {
method: "PATCH",
headers: {
Authorization: `Bearer ${process.env.JOIN_MARKT_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"type": "add",
"amount": 1
}),
})
const data = await res.json()import os, requests
res = requests.patch(
"https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/customers/{customerKey}/balance",
headers={"Authorization": f"Bearer {os.environ['JOIN_MARKT_API_KEY']}"},
json={
"type": "add",
"amount": 1
},
)
data = res.json(){}{
"error": "Product not found",
"code": "NOT_FOUND"
}{
"error": "Product not found",
"code": "NOT_FOUND"
}{
"error": "Product not found",
"code": "NOT_FOUND"
}{
"error": "Product not found",
"code": "NOT_FOUND"
}{
"error": "Product not found",
"code": "NOT_FOUND"
}Adjust a customer balance
Add to or subtract from the customer store balance. The change is logged.
Scope: customer:balance:write
This changes real data in your store, including when you press Send here.
PATCH
/
api
/
merchant
/
v1
/
stores
/
{storeId}
/
customers
/
{customerKey}
/
balance
cURL
curl -X PATCH "https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/customers/{customerKey}/balance" \
-H "Authorization: Bearer $JOIN_MARKT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"add","amount":1}'const res = await fetch("https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/customers/{customerKey}/balance", {
method: "PATCH",
headers: {
Authorization: `Bearer ${process.env.JOIN_MARKT_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"type": "add",
"amount": 1
}),
})
const data = await res.json()import os, requests
res = requests.patch(
"https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/customers/{customerKey}/balance",
headers={"Authorization": f"Bearer {os.environ['JOIN_MARKT_API_KEY']}"},
json={
"type": "add",
"amount": 1
},
)
data = res.json(){}{
"error": "Product not found",
"code": "NOT_FOUND"
}{
"error": "Product not found",
"code": "NOT_FOUND"
}{
"error": "Product not found",
"code": "NOT_FOUND"
}{
"error": "Product not found",
"code": "NOT_FOUND"
}{
"error": "Product not found",
"code": "NOT_FOUND"
}Authorizations
Your Merchant API key. Create one in Dashboard → Developers → API keys.
Path Parameters
Your store id. Find it in Dashboard → Developers, or in GET /stores with MCP.
Customer email, or the customer id.
Body
application/json
Response
The new balance.
The response is of type object.

