---
title: "Confirm a coin pack purchase after FunnelFox SDK onSuccess"
method: POST
path: "/v1/coins/confirm-purchase"
tags: ["Coins"]
---

# Confirm a coin pack purchase after FunnelFox SDK onSuccess

`POST /v1/coins/confirm-purchase`

Verifies the one-off coin purchase with FunnelFox and credits the coins immediately. Idempotent — keyed by orderId, so it never double-grants with the oneoff/order webhook.

## Request body

- ConfirmCoinPurchaseDto
  - `pricePointIdent` string, required — FunnelFox price point ident of the purchased coin pack
  - `orderId` string, required — FunnelFox order id returned by the checkout SDK onSuccess. Used as the idempotency key so this grant can never double up with the webhook.

## Response `200`

- ConfirmCoinPurchaseResponseDto
  - `success` boolean, required — Whether the purchase was confirmed and credited
  - `balance` number, required — Current total coin balance after crediting
  - `coinsAmount` number — Coins credited by this purchase (before any top-up multiplier)

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc.dev/miaai/apis/backend-template-api/revisions/2a8d88a5124f?raw)
