Aceita uma oferta e inicia a contratação

POST

/api/v1/fgts/applications/{application_id}/offers/{offer_id}/accept

Seleciona uma oferta do menu e inicia a contratação. Responde 202: assinatura, averbação e desembolso seguem em background.

Aceite é único por solicitação e exige KYC submetido. A oferta precisa estar AVAILABLE e dentro de expires_at.

Recusa do banco não é erro desta chamada. Se o banco recusar, esta requisição já terá respondido 202; a recusa aparece depois em offers[].rejection_reason, com a solicitação em CONTRACT_REJECTED — estado do qual você pode aceitar outra oferta do menu.

Requisição

Authorization

JWT Bearer

Adicionar o parâmetro

Authorization

a Cabeçalhos

Exemplo:

Authorization: ********************

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/json

Examples

Respostas

🟢202

application/json

Aceite registrado; a contratação começou.

Bodyapplication/json

🟠400

🟠401

🟠404

🟠409

🟠422

🔴500

🔴502

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://gtw.unnotech.com.br/public/api/v1/fgts/applications/3f6a1b2c-8d4e-4f10-9a7b-2c5e6d8f0a13/offers/of_9f2c41a7e8b34d61/accept' \
--header 'Idempotency-Key: 5c8e1a92-7b30-4f6d-a1c4-3e9d2b7f0851' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "bank_account": {
        "type": "CC",
        "agency": "1234",
        "bank_code": "001",
        "agency_digit": "1",
        "account_number": "567890123",
        "account_digit": "5"
    }
}'

Response Example

202 - Exemplo 1

{
    "proposal_uuid": "b81c9f30-5a24-4e6d-91f8-7d3a0c5b2e64",
    "status": "QUOTING"
}

Modificado em 2026-07-28 02:36:49

Página anterior

Re-cota uma application (ofertas antigas invalidadas)

Próxima página

Lê o KYC (pré-preenchido quando disponível na plataforma)