---
title: "Grant credits to a customer"
method: POST
path: "/v1/sdk/customers/{reference}/credits"
tags: ["Customers"]
---

# Grant credits to a customer

`POST /v1/sdk/customers/{reference}/credits`

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

## Path parameters

- `reference` string, required

## Headers

- `Idempotency-Key` string

## Request body

- GrantCustomerCreditsRequest
  - `credits` integer, required
  - `reason` string

## Response `200`

Credits granted successfully

- GrantCustomerCreditsResponse
  - `balance` number, required — Customer credit balance after the grant
  - `credits` number, required — Granted credit amount
  - `customerRef` string, required — Customer reference identifier
  - `reason` string — Machine-readable grant reason
  - `success` boolean, required — Whether the grant was recorded

## Other responses

- `404` — Customer not found

---

[API](https://skmtc.net/solvapay/apis/solvapay-rest-api.md) · [All operations](https://skmtc.net/solvapay/apis/solvapay-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solvapay/solvapay-rest-api/versions/bbc2ff2bc849/schema)