> ## Documentation Index > Fetch the complete documentation index at: https://nexus-docs.ticto.dev/llms.txt > Use this file to discover all available pages before exploring further. # charge_reminder > Disparado como lembrete antes de uma cobrança recorrente. **Quando ocorre:** - 2 dias antes do vencimento (D-2) - No dia do vencimento (D+0) **Dados condicionais por método de pagamento:** - `credit_card` / `google_pay` / `apple_pay`: apenas dados da assinatura (cobrança automática) - `bank_slip`: inclui `bank_slip_code`, `bank_slip_url` e `bank_slip_due_date` - `pix_recurring`: inclui `pix_qr_code` ## OpenAPI ````yaml /api-reference/openapi.yaml post /webhook-events/charge_reminder openapi: 3.0.3 info: title: Nexus version: 1.0.2 description: > API para integração entre Ticto e clientes externos # Autenticação Para autenticar as solicitações aos endpoints descritos a seguir, por favor, siga os passos abaixo: 1. **Solicite** seu cadastro como cliente através do e-mail **infraestrutura@ticto.com.br** para obter seu `client_id` e `token`. 2. **Use** seu token e ID de cliente para fazer login no Nexus e obter seu `client_token`. 3. **Em todas as outras requisições**, envie seu `client_token` no header como `X-Api-Client-Token`. 4. **Crie** seus usuários na rota de criação de usuário. Para cada usuário, será retornado um `public_token` único. 5. **Para endpoints que não estão em public.php**, adicione o `public_token` do usuário no cabeçalho **Authorization** utilizando o formato: ```http Authorization: Bearer {public_token} ``` ## Restrição de origem O acesso a esta API não está disponível para todos os sellers. Seu uso é estritamente permitido para parceiros comerciais que a utilizarão em cenários específicos. Por este motivo, o acesso será restrito a endereços IP e domínios previamente informados por esses parceiros. Essa medida visa proporcionar um ambiente mais controlado e seguro para todos os nossos usuários e parceiros. ### O que isso significa para os desenvolvedores? - **Acesso Limitado:** Somente os IPs e domínios pré-autorizados poderão realizar chamadas à API. Qualquer tentativa de acesso de um IP ou domínio não listado será automaticamente rejeitada. - **Processo de Autorização:** Para garantir a continuidade do acesso à API sem interrupções, é essencial que os desenvolvedores enviem os endereços IP ou domínios que necessitam de acesso diretamente à nossa equipe de suporte. - **Como Solicitar Acesso:** Envie um e-mail para **liberacao@ticto.com.br** com o assunto _"Solicitação de Acesso à API de pagamentos"_, incluindo: - Nome da empresa ou do desenvolvedor - Endereços IP ou domínios a serem autorizados - Justificativa para o acesso - Informações de contato para eventuais esclarecimentos ## Alterações e/ou inclusão de novos domínios e IPs Recomendamos que solicitações de adição ou alteração de IPs/domínios sejam feitas o mais breve possível para garantir uma transição suave. Em casos de alterações, os domínios e/ou IPs anteriores serão imediatamente bloqueados após sua remoção. ## Suporte e Dúvidas Para dúvidas ou suporte adicional, entre em contato conosco através do e-mail **liberacao@ticto.com.br**. Estamos comprometidos em auxiliar neste processo e garantir a melhor experiência possível. servers: - url: https://nexus.ticto.com.br/api/v1 description: Produção security: [] tags: - name: Autenticação - name: Configurações do Cliente - name: Usuários - name: Onboarding de usuário - name: Contas Bancárias - name: Faixas de Taxa description: >- Endpoints para consulta de faixas de taxa personalizadas e histórico de alterações. - name: Frete - name: Financeiro - name: PIX Automático description: >- Consulta, cancelamento e nova tentativa de cobrança de assinaturas com PIX Automático (débito recorrente autorizado pelo pagador). - name: Produtos - name: Integrações - name: 'Webhooks: Usuários' description: Eventos relacionados a cadastro e atualização de usuários. - name: 'Webhooks: Contas Bancárias' description: Eventos relacionados a contas bancárias dos sellers. - name: 'Webhooks: Produtos e Ofertas' description: Eventos relacionados a produtos, ofertas, afiliados e coprodutores. - name: 'Webhooks: Financeiro' description: Eventos de reembolso, saque e antecipação. - name: 'Webhooks: Faixas de Taxa' description: Eventos de criação, atualização e exclusão de faixas de taxa. - name: 'Webhooks: Pedidos' description: Eventos de criação e atualização de pedidos. - name: 'Webhooks: Cobranças' description: >- Eventos de criação e mudança de status de cobranças (transações), na primeira compra e nas renovações. - name: 'Webhooks: Assinaturas' description: Eventos do ciclo de vida de assinaturas, cobranças e trial. paths: /webhook-events/charge_reminder: post: tags: - 'Webhooks: Assinaturas' summary: charge_reminder description: > Disparado como lembrete antes de uma cobrança recorrente. **Quando ocorre:** - 2 dias antes do vencimento (D-2) - No dia do vencimento (D+0) **Dados condicionais por método de pagamento:** - `credit_card` / `google_pay` / `apple_pay`: apenas dados da assinatura (cobrança automática) - `bank_slip`: inclui `bank_slip_code`, `bank_slip_url` e `bank_slip_due_date` - `pix_recurring`: inclui `pix_qr_code` operationId: webhookChargeReminder requestBody: required: true content: application/json: schema: allOf: - $ref: '#/components/schemas/WebhookEnvelope' - type: object properties: payload: $ref: '#/components/schemas/WebhookChargeReminderPayload' examples: credit_card: summary: Cartão de crédito (aviso) value: event: charge_reminder endpoint: https://api.meusite.com/webhook/nexus payload: subscription_code: TS7QK4M2XJ9BVN5RLD3W status: active next_charge: '2026-03-01 14:30:00' days_before_charge: 2 amount: 19700 payment_method: credit_card product_hash: PRD_abc123 offer_code: OFF_xyz789 buyer: name: Maria Santos email: maria@email.com reminder_sent_at: '2026-02-27T10:00:00.000000Z' metadata: origin: nexus request_id: 67be1a2f3c4d5 correlation_id: null created_at: '2026-02-27T10:00:00.000000Z' updated_at: '2026-02-27T10:00:00.000000Z' bank_slip: summary: Boleto (com código de barras) value: event: charge_reminder endpoint: https://api.meusite.com/webhook/nexus payload: subscription_code: TS7QK4M2XJ9BVN5RLD3W status: active next_charge: '2026-03-01 14:30:00' days_before_charge: 2 amount: 29900 payment_method: bank_slip product_hash: PRD_abc123 offer_code: OFF_xyz789 buyer: name: João Silva email: joao@email.com bank_slip_code: 23793.38128 60000.000003 00000.000400 1 99999999999 bank_slip_url: https://gateway.com/pdf/boleto.pdf bank_slip_due_date: '2026-03-01' reminder_sent_at: '2026-02-27T10:00:00.000000Z' metadata: origin: nexus request_id: 67be1a2f3c4d5 correlation_id: null created_at: '2026-02-27T10:00:00.000000Z' updated_at: '2026-02-27T10:00:00.000000Z' pix_recurring: summary: PIX Automático (com QR code) value: event: charge_reminder endpoint: https://api.meusite.com/webhook/nexus payload: subscription_code: TS7QK4M2XJ9BVN5RLD3W status: active next_charge: '2026-03-01 14:30:00' days_before_charge: 2 amount: 4949 payment_method: pix_recurring product_hash: PRD_abc123 offer_code: OFF_xyz789 buyer: name: Ana Costa email: ana@email.com pix_qr_code: >- 00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890 reminder_sent_at: '2026-02-27T10:00:00.000000Z' metadata: origin: nexus request_id: 67be1a2f3c4d5 correlation_id: null created_at: '2026-02-27T10:00:00.000000Z' updated_at: '2026-02-27T10:00:00.000000Z' responses: '200': description: Webhook recebido com sucesso components: schemas: WebhookEnvelope: type: object description: | Envelope padrão de todos os webhooks enviados pelo Nexus. O campo `payload` varia conforme o evento. required: - event - endpoint - payload - metadata - created_at - updated_at properties: event: type: string description: Nome do evento disparado example: user_updated endpoint: type: string format: url description: URL do webhook configurada pelo cliente example: https://api.meusite.com/webhook/nexus payload: type: object description: Dados específicos do evento (varia por evento) metadata: $ref: '#/components/schemas/WebhookMetadata' created_at: type: string format: date-time description: Data de criação do webhook (ISO 8601) example: '2026-02-25T10:00:00.000000Z' updated_at: type: string format: date-time description: Data de atualização do webhook (ISO 8601) example: '2026-02-25T10:00:00.000000Z' WebhookChargeReminderPayload: type: object description: | Payload do evento `charge_reminder`. Disparado 2 dias antes e no dia do vencimento de uma assinatura. Campos de pagamento são condicionais ao `payment_method`. required: - subscription_code - next_charge - days_before_charge - amount - payment_method properties: subscription_code: type: string description: Código único da assinatura example: TS7QK4M2XJ9BVN5RLD3W status: type: string description: Status atual da assinatura example: active next_charge: type: string description: Data da próxima cobrança (Y-m-d H:i:s) example: '2026-03-01 14:30:00' days_before_charge: type: integer description: Dias restantes até a cobrança (2 ou 0) example: 2 amount: type: integer description: Valor da cobrança em centavos example: 19700 payment_method: type: string description: Método de pagamento da assinatura enum: - credit_card - bank_slip - pix_recurring - google_pay - apple_pay example: credit_card product_hash: type: string description: Hash do produto example: PRD_abc123 offer_code: type: string description: Código da oferta example: OFF_xyz789 buyer: type: object description: Dados do comprador properties: name: type: string example: Maria Santos email: type: string format: email example: maria@email.com bank_slip_code: type: string nullable: true description: >- Código de barras do boleto (apenas quando payment_method = bank_slip) example: 23793.38128 60000.000003 00000.000400 1 99999999999 bank_slip_url: type: string nullable: true description: URL do PDF do boleto (apenas quando payment_method = bank_slip) example: https://gateway.com/pdf/boleto.pdf bank_slip_due_date: type: string nullable: true description: >- Data de vencimento do boleto (apenas quando payment_method = bank_slip) example: '2026-03-01' pix_qr_code: type: string nullable: true description: >- Código QR do PIX / BRCode para copia e cola (apenas quando payment_method = pix_recurring) example: 00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890 reminder_sent_at: type: string format: date-time description: Data de envio do lembrete (ISO 8601) example: '2026-02-27T10:00:00.000000Z' WebhookMetadata: type: object description: Metadados de rastreamento do webhook properties: origin: type: string description: Sistema de origem do evento example: nexus request_id: type: string description: ID único da requisição para rastreamento example: 67be1a2f3c4d5 correlation_id: type: string nullable: true description: ID de correlação (quando disponível) example: null ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.