> For the complete documentation index, see [llms.txt](https://docs.giro.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/contratos/confirmar-aprovacao-pagamento.md).

# Confirmar Aprovação de Pagamento

Libera para formalização um contrato averbado que aguarda sua aprovação (`PENDING_PAYMENT_APPROVAL`). Passo a passo no guia [Aprovação de Pagamento](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/aprovacao-de-pagamento.md).

## Request

`POST /api/v1/originator/contracts/{contractNumber}/payment-approval`

Autenticação: `Authorization: Bearer {originatorToken}`. Sem corpo.

### Parâmetros

| Parâmetro        | Local | Tipo     | Obrigatório | Descrição                                                                   |
| ---------------- | ----- | -------- | ----------- | --------------------------------------------------------------------------- |
| `contractNumber` | path  | `string` | Sim         | Número do contrato (CCB) em `PENDING_PAYMENT_APPROVAL` (máx. 50 caracteres) |

## Regras de aprovação

* Só se aplica quando o originador tem `requiresPaymentApproval = true` e `formalizationStrategy = GTBANKER`. Sem isso, o contrato vai direto da averbação para a formalização.
* O contrato deve estar em `PENDING_PAYMENT_APPROVAL` e pertencer ao originador autenticado.
* **Não há endpoint de rejeição.** Para não prosseguir, use a [desaverbação](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/contratos/desaverbar-contrato.md) (`POST /contracts/exclude`).
* Assíncrono: responde `202`, o contrato passa a `ENDORSED` e segue para formalização (`FORMALIZED` → `COMPLETED`).

## Response

`202 Accepted`:

| Campo            | Tipo     | Descrição                                     |
| ---------------- | -------- | --------------------------------------------- |
| `requestNumber`  | `string` | Número da requisição do contrato              |
| `contractNumber` | `string` | Número do contrato (CCB)                      |
| `status`         | `string` | Estado do contrato após o aceite — `ENDORSED` |
| `message`        | `string` | Mensagem explicativa sobre o processamento    |

## Exemplo

```http
POST /api/v1/originator/contracts/00345678/payment-approval HTTP/1.1
Host: api.giro.tech
Authorization: Bearer {originatorToken}
```

Resposta `202`:

```json
{
  "contractPublicId": "0198f2a1-7c3e-7b2d-9f14-3a5c8e6d1b07",
  "requestNumber": "GTAB12CD34EF",
  "contractNumber": "00345678",
  "status": "ENDORSED",
  "message": "Aprovação de pagamento confirmada; contrato enviado para formalização."
}
```

## Erros

| Código | `errorCode`                             | Situação                                                 |
| ------ | --------------------------------------- | -------------------------------------------------------- |
| 404    | —                                       | Contrato não encontrado ou de outro originador           |
| 409    | `CONTRACT_NOT_PENDING_PAYMENT_APPROVAL` | Contrato fora de `PENDING_PAYMENT_APPROVAL`. Não retente |
| 429    | —                                       | Mais de 75 requisições por segundo                       |

Erros comuns a todos os endpoints — `401`, `403` de token, `409` de `Idempotency-Key` em processamento, `500` e `503` — e o formato `ProblemDetail` estão em [Erros da API](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/erros.md).

## Webhooks relacionados

| Evento                               | Quando                                                              |
| ------------------------------------ | ------------------------------------------------------------------- |
| `CONTRACT_PAYMENT_APPROVAL_REQUIRED` | Contrato entrou em `PENDING_PAYMENT_APPROVAL` e aguarda confirmação |
| `ENDORSEMENT_ENDORSED`               | Averbação concluída (disparado antes do evento acima)               |

Detalhes em [Eventos e Payloads](https://docs.giro.tech/desenvolvedores/api-gtpayroll/webhooks/eventos-e-payloads.md#contract_payment_approval_required).

## Confirmar Aprovação de Pagamento

> Confirma o envio de um contrato já averbado à formalização no GTBanker, para originadores\
> configurados com \`requiresPaymentApproval\`. Aplicável apenas a contratos no estado\
> \`PENDING\_PAYMENT\_APPROVAL\` (averbados, aguardando a confirmação do originador).\
> \
> Processamento assíncrono: o contrato transiciona para \`ENDORSED\` e é enfileirado para a\
> formalização no GTBanker. Para \*\*rejeitar\*\* (em vez de aprovar), use a desaverbação\
> (\`POST /contracts/exclude\`).<br>

```json
{"openapi":"3.0.0","info":{"title":"GT Payroll Originator API","version":"1.1.0"},"tags":[{"name":"Contracts","description":"Contratos de empréstimo"}],"servers":[{"url":"https://ingress.gtpayroll.staging.giro.tech","description":"Ambiente de Staging"},{"url":"https://ingress.gtpayroll.giro.tech","description":"Ambiente de Produção"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT token fornecido pelo administrador"}}},"paths":{"/api/v1/originator/contracts/{contractNumber}/payment-approval":{"post":{"summary":"Confirmar Aprovação de Pagamento","description":"Confirma o envio de um contrato já averbado à formalização no GTBanker, para originadores\nconfigurados com `requiresPaymentApproval`. Aplicável apenas a contratos no estado\n`PENDING_PAYMENT_APPROVAL` (averbados, aguardando a confirmação do originador).\n\nProcessamento assíncrono: o contrato transiciona para `ENDORSED` e é enfileirado para a\nformalização no GTBanker. Para **rejeitar** (em vez de aprovar), use a desaverbação\n(`POST /contracts/exclude`).\n","tags":["Contracts"],"parameters":[{"name":"contractNumber","in":"path","required":true,"description":"Número do contrato a confirmar","schema":{"type":"string","minLength":1,"maxLength":50}}],"responses":{"202":{"description":"Aprovação aceita (contrato enviado para formalização)","content":{"application/json":{"schema":{"type":"object","description":"Resposta 202 da confirmação de aprovação de pagamento (processamento assíncrono).","properties":{"publicId":{"type":"string","maxLength":36,"description":"Identificador público do contrato. Pode vir omitido (ausente no JSON) em contratos antigos."},"requestNumber":{"type":"string","maxLength":36},"contractNumber":{"type":"string"},"status":{"type":"string","enum":["ENDORSED"],"description":"Estado do contrato após a aprovação (segue para formalização)."},"message":{"type":"string"}}}}}},"401":{"description":"Não autenticado","content":{"application/problem+json":{"schema":{"type":"object","description":"Erro de autenticação (HTTP 401). Token ausente, com prefixo diferente de `Bearer `, expirado, revogado ou inválido.","required":["type","title","status"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"properties":{"type":"object","nullable":true,"description":"Extensões do ProblemDetail. Ausente (`null`) nas respostas `about:blank`.","additionalProperties":true,"properties":{"message":{"type":"string","description":"Repete o `detail`."},"errorCode":{"type":"string","description":"Código estável da regra violada. Opcional: só parte dos erros de regra de negócio tem.\nLista por status no guia de erros.\n"},"errors":{"type":"object","additionalProperties":{"type":"string"},"description":"(Apenas 400 `validation-error`) Mapa campo → mensagem."},"retryAfter":{"type":"integer","description":"(429 e 503) Segundos a aguardar antes de nova requisição."},"limit":{"type":"integer","description":"(Apenas 429) Limite de requisições da janela."},"resetAt":{"type":"integer","format":"int64","description":"(Apenas 429) Fim da janela, em epoch **milissegundos**."}}}}}}}},"403":{"description":"Permissão insuficiente","content":{"application/problem+json":{"schema":{"type":"object","description":"Erro de autorização (HTTP 403). Token válido de outro perfil, sem permissão de originador.\nRecusas de permissão por regra de negócio (ex.: `ORIGINATOR_OPT_IN_NOT_ENABLED`) usam\n`#business-rule-violation` com `properties.errorCode`.\n","required":["type","title","status"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"properties":{"type":"object","nullable":true,"description":"Extensões do ProblemDetail. Ausente (`null`) nas respostas `about:blank`.","additionalProperties":true,"properties":{"message":{"type":"string","description":"Repete o `detail`."},"errorCode":{"type":"string","description":"Código estável da regra violada. Opcional: só parte dos erros de regra de negócio tem.\nLista por status no guia de erros.\n"},"errors":{"type":"object","additionalProperties":{"type":"string"},"description":"(Apenas 400 `validation-error`) Mapa campo → mensagem."},"retryAfter":{"type":"integer","description":"(429 e 503) Segundos a aguardar antes de nova requisição."},"limit":{"type":"integer","description":"(Apenas 429) Limite de requisições da janela."},"resetAt":{"type":"integer","format":"int64","description":"(Apenas 429) Fim da janela, em epoch **milissegundos**."}}}}}}}},"404":{"description":"Contrato não encontrado para o originador","content":{"application/problem+json":{"schema":{"type":"object","description":"Resposta de erro no formato RFC 7807 (Problem Details). Os campos extras **não** vêm na raiz:\nficam dentro de `properties` (`message`, `errorCode`, `errors`, `retryAfter`…).\n\nIdentifique o erro por `status` + `properties.errorCode`. O `type` agrupa famílias e sozinho não\nidentifica o erro: `#business-rule-violation` aparece com 400, 403, 404, 409, 413, 422 e 503.\nCatálogo completo em https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/erros.\n","required":["type","title","status"],"properties":{"type":{"type":"string","description":"URL do guia de erros com o fragmento da família: `validation-error`, `not-authenticated`,\n`forbidden`, `resource-not-found`, `conflict`, `business-rule-violation`,\n`dataprev-suspension-window`, `rate-limit-exceeded`, `internal-error`, `upstream-error`,\n`service-unavailable`. Corpo ilegível, parâmetro de tipo errado, rota inexistente, `405` e\n`415` vêm como `about:blank`, sem `properties`.\n"},"title":{"type":"string","description":"Resumo curto. Na maioria dos casos é a frase padrão do status HTTP."},"status":{"type":"integer","description":"Código HTTP do erro"},"detail":{"type":"string","description":"Mensagem legível desta ocorrência. Pode mudar de texto; use `properties.errorCode` para automação."},"instance":{"type":"string","description":"Path da requisição que falhou"},"properties":{"type":"object","nullable":true,"description":"Extensões do ProblemDetail. Ausente (`null`) nas respostas `about:blank`.","additionalProperties":true,"properties":{"message":{"type":"string","description":"Repete o `detail`."},"errorCode":{"type":"string","description":"Código estável da regra violada. Opcional: só parte dos erros de regra de negócio tem.\nLista por status no guia de erros.\n"},"errors":{"type":"object","additionalProperties":{"type":"string"},"description":"(Apenas 400 `validation-error`) Mapa campo → mensagem."},"retryAfter":{"type":"integer","description":"(429 e 503) Segundos a aguardar antes de nova requisição."},"limit":{"type":"integer","description":"(Apenas 429) Limite de requisições da janela."},"resetAt":{"type":"integer","format":"int64","description":"(Apenas 429) Fim da janela, em epoch **milissegundos**."}}}}}}}},"409":{"description":"Contrato fora de `PENDING_PAYMENT_APPROVAL`, ou `Idempotency-Key` em processamento.","content":{"application/problem+json":{"schema":{"type":"object","description":"Resposta de erro no formato RFC 7807 (Problem Details). Os campos extras **não** vêm na raiz:\nficam dentro de `properties` (`message`, `errorCode`, `errors`, `retryAfter`…).\n\nIdentifique o erro por `status` + `properties.errorCode`. O `type` agrupa famílias e sozinho não\nidentifica o erro: `#business-rule-violation` aparece com 400, 403, 404, 409, 413, 422 e 503.\nCatálogo completo em https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/erros.\n","required":["type","title","status"],"properties":{"type":{"type":"string","description":"URL do guia de erros com o fragmento da família: `validation-error`, `not-authenticated`,\n`forbidden`, `resource-not-found`, `conflict`, `business-rule-violation`,\n`dataprev-suspension-window`, `rate-limit-exceeded`, `internal-error`, `upstream-error`,\n`service-unavailable`. Corpo ilegível, parâmetro de tipo errado, rota inexistente, `405` e\n`415` vêm como `about:blank`, sem `properties`.\n"},"title":{"type":"string","description":"Resumo curto. Na maioria dos casos é a frase padrão do status HTTP."},"status":{"type":"integer","description":"Código HTTP do erro"},"detail":{"type":"string","description":"Mensagem legível desta ocorrência. Pode mudar de texto; use `properties.errorCode` para automação."},"instance":{"type":"string","description":"Path da requisição que falhou"},"properties":{"type":"object","nullable":true,"description":"Extensões do ProblemDetail. Ausente (`null`) nas respostas `about:blank`.","additionalProperties":true,"properties":{"message":{"type":"string","description":"Repete o `detail`."},"errorCode":{"type":"string","description":"Código estável da regra violada. Opcional: só parte dos erros de regra de negócio tem.\nLista por status no guia de erros.\n"},"errors":{"type":"object","additionalProperties":{"type":"string"},"description":"(Apenas 400 `validation-error`) Mapa campo → mensagem."},"retryAfter":{"type":"integer","description":"(429 e 503) Segundos a aguardar antes de nova requisição."},"limit":{"type":"integer","description":"(Apenas 429) Limite de requisições da janela."},"resetAt":{"type":"integer","format":"int64","description":"(Apenas 429) Fim da janela, em epoch **milissegundos**."}}}}}}}},"429":{"description":"Mais de 75 requisições por segundo. Aguarde o header `Retry-After` e reenvie com **nova** `Idempotency-Key` — com a mesma chave, o `429` gravado é repetido.","content":{"application/problem+json":{"schema":{"type":"object","description":"Resposta de erro no formato RFC 7807 (Problem Details). Os campos extras **não** vêm na raiz:\nficam dentro de `properties` (`message`, `errorCode`, `errors`, `retryAfter`…).\n\nIdentifique o erro por `status` + `properties.errorCode`. O `type` agrupa famílias e sozinho não\nidentifica o erro: `#business-rule-violation` aparece com 400, 403, 404, 409, 413, 422 e 503.\nCatálogo completo em https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/erros.\n","required":["type","title","status"],"properties":{"type":{"type":"string","description":"URL do guia de erros com o fragmento da família: `validation-error`, `not-authenticated`,\n`forbidden`, `resource-not-found`, `conflict`, `business-rule-violation`,\n`dataprev-suspension-window`, `rate-limit-exceeded`, `internal-error`, `upstream-error`,\n`service-unavailable`. Corpo ilegível, parâmetro de tipo errado, rota inexistente, `405` e\n`415` vêm como `about:blank`, sem `properties`.\n"},"title":{"type":"string","description":"Resumo curto. Na maioria dos casos é a frase padrão do status HTTP."},"status":{"type":"integer","description":"Código HTTP do erro"},"detail":{"type":"string","description":"Mensagem legível desta ocorrência. Pode mudar de texto; use `properties.errorCode` para automação."},"instance":{"type":"string","description":"Path da requisição que falhou"},"properties":{"type":"object","nullable":true,"description":"Extensões do ProblemDetail. Ausente (`null`) nas respostas `about:blank`.","additionalProperties":true,"properties":{"message":{"type":"string","description":"Repete o `detail`."},"errorCode":{"type":"string","description":"Código estável da regra violada. Opcional: só parte dos erros de regra de negócio tem.\nLista por status no guia de erros.\n"},"errors":{"type":"object","additionalProperties":{"type":"string"},"description":"(Apenas 400 `validation-error`) Mapa campo → mensagem."},"retryAfter":{"type":"integer","description":"(429 e 503) Segundos a aguardar antes de nova requisição."},"limit":{"type":"integer","description":"(Apenas 429) Limite de requisições da janela."},"resetAt":{"type":"integer","format":"int64","description":"(Apenas 429) Fim da janela, em epoch **milissegundos**."}}}}}}}}}}}}}
```

{% embed url="<https://giro.tech/central-de-atendimento/>" %}
