---
title: "/finaliza_compra"
method: POST
path: "/finaliza_compra"
---

# /finaliza_compra

`POST /finaliza_compra`

API para finalização da compra e encerramento do processo de bonificação do e-commerce.

## Headers

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

## Request body

- object
  - `user_id` integer, required — ID do cliente na CRMBonus.
  - `valor_bruto` number, float, required — Valor da compra antes da aplicação do saldo de bônus.
  - `bonus_resgatado` integer, required — Valor de bônus resgatado nesta compra.
  - `ids_bonus` string — **Obrigatório quando houver resgate**. ID do bônus que será resgatado. Se múltiplos, separe-os por vírgula. <br><br>**💡 Tip:** Valore(s) retornado(s) no endpoint [/consulta_bonus](https://crmbonus-api.readme.io/reference/consulta_bonus).
  - `ticket` string, required — Identificador da compra ou pedido no sistema.
  - `campanha_id` string, required — Id da campanha para geração do bônus. **💡 Tip:** Valore(s) retornado(s) no endpoint [/campanha_disponivel](https://crmbonus-api.readme.io/reference/campanha-disponivel)
  - `items` object[] — **⚠️Importante:** Este parâmetro torna-se obrigatório quando a feature flag *Motor v2* está ativa. Produtos selecionados na compra
    - `sku` string — Identificador do produto
    - `value_of` number, float — Valor base de referência do produto
    - `value_per` number, float — Valor do produto com desconto
    - `quantity` number, float — Quantidade do produto
  - `payments` object[] — **⚠️Importante:** Este parâmetro torna-se obrigatório quando a feature flag *Motor v2* está ativa. Dados do pagamento
    - `id` string — Identificador do pagamento
    - `system_id` string — Identificador do sistema
    - `system_name` string — Bandeira do sistema
    - `type` string — CREDIT_CARD, DEBIT_CARD, CASH, PIX, BANK_SLIP, DIGITAL_WALLET, CHECK, FREIGHT_CARD, STORE_CARD, FOOD_VOUCHER, GIFT_CARD, FUEL_VOUCHER, BANK_DEPOSIT, BANK_TRANSFER, LOYALTY_PROGRAM, CASHBACK, STORE_CREDIT, INSTALLMENT_PLAN, UNSPECIFIED_ELECTRONIC_PAYMENT
    - `value` number, float — Valor do pagamento
    - `installments` integer — Parcela do pagamento
  - `delivery` object[] — **⚠️Importante:** Este parâmetro torna-se obrigatório quando a feature flag *Motor v2* está ativa. Dados da entrega
    - `type` string — PICKUP, STANDARD, EXPRESS, SCHEDULED
    - `fee` number, float
  - `totals` object[] — **⚠️Importante:** Este parâmetro torna-se obrigatório quando a feature flag *Motor v2* está ativa. Subtotal da compra e descontos aplicados.
    - `fee` number, float
    - `taxes` number, float
    - `subtotal` number, float — Valor bruto da compra.
    - `crm_discounts` number, float — Descontos aplicados na CRMBonus
    - `other_discounts` number, float — Outros descontos
    - `total` number, float — Valor líquido da compra.

## 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/revisions/7f3ebb042f1a/schema)