---
title: "/bonus/execute"
method: POST
path: "/bonus/execute"
---

# /bonus/execute

`POST /bonus/execute`

Endpoint para resgate e/ou geração de bônus

## Headers

- `Authorization` string, required
- `CodEmpresa` string
- `Content-Type` string, required
- `System-Name` string, required
- `User-Agent` string, required

## Request body

- object
  - `user` object, required — Dados do cliente
    - `phone` string, required — Celular do cliente sem máscara Exemplos: 11999998888
    - `name` string — Nome do cliente
    - `email` string — Email do cliente
    - `cpf` string — CPF do cliente sem máscara. Exemplo: 49594126078
  - `gross_value` number, float, required — Valor da compra antes da aplicação do saldo de bônus.
  - `generated_bonus` object — Dados para geração do bônus
    - `expiration_date_start` string — Data inicial de validade inicial do bônus. Exemplo: "2025-01-01T00:00:00"
    - `expiration_date_end` string — Data inicial de validade final do bônus. Exemplo: "2025-01-01T00:00:00"
    - `value` number, float — Valor do bônus gerado
  - `redeemed_bonus` object — Dados para resgate do bônus
    - `bonus_ids` string[] — Ids dos bônus que estão sendo resgatados
    - `value` number, float — Valor dos bônus que estão sendo resgatadois
  - `internal_order_id` string, required — Identificador da compra ou pedido no sistema.

## Response `200`

200

- object
  - `status` boolean
  - `message` string
  - `data` object
    - `bonus_id` integer
    - `order_id` integer
    - `ticket` string

---

[API](https://skmtc.net/crmbonus/apis/bi-crmb-nus.md) · [All operations](https://skmtc.net/crmbonus/apis/bi-crmb-nus/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crmbonus/bi-crmb-nus/versions/7f3ebb042f1a/schema)