Skip to main content
POST
Redeem cashback
Requires a source IP on the legal entity’s enabled IP allowlist.

Authorizations

X-API-Key
string
header
required

User API key authentication. Create a key under Settings → API keys in the Slash dashboard (https://app.slash.com/global-settings/api-keys) and send the x-legal-entity header naming the legal entity to act on with every request. Keys scoped to a legal entity are rejected with 403 user_api_key_required.

Headers

X-Idempotency-Key
string
required

Unique caller-generated key for one create request. Once an authenticated, schema-valid request reaches the operation, the key is permanently consumed for that operation and legal entity whether the operation succeeds or fails. Reusing it in that scope returns 409 and never replays a response, unlike API v1, which replays the original response for a matching key.

Required string length: 1 - 255

The legal entity to act on. Required on every request except GET /v2/legal-entities, which lists the ids a user API key can send here: those of every legal entity its user has access to.

Pattern: ^le_[a-zA-Z0-9]+$

Body

application/json
accountId
string
required

The account whose cashback to redeem, with the sa_group_ prefix.

Example:

"sa_group_2rj4l7hmrrrcv"

amount
UsdMoney · object
required

Up to the account's available cashback.

destination
CashbackRedemptionDestinationAccount · object
required

One of the legal entity's accounts. The cashback lands in its primary virtual account.

Response

The redemption.

Cashback paid out of an account's balance.

id
string
required

Redemption id with the transfer_intent_ prefix.

Example:

"transfer_intent_2rj4l7hmrrrcv"

status
enum<string>
required

returned when the recipient's bank sends the ACH back; the cashback goes back to the balance.

Available options:
pending,
completed,
returned,
failed
Example:

"completed"

accountId
string
required

The account whose cashback was redeemed.

Example:

"sa_group_2rj4l7hmrrrcv"

amount
Money · object
required

A signed monetary amount expressed in minor units.

destination
CashbackRedemptionDestinationAccount · object
required

Where the cashback went.

createdAt
string<date-time>
required
Example:

"2026-10-22T00:12:00.000Z"

completedAt
string<date-time>

When the cashback was paid out.

Example:

"2026-10-22T00:12:03.000Z"