Notificação de Pagamentos com Cartão

Notificação de pagamentos com cartão

Quando um pagamento com cartão sofrer uma mudança em seu transaction_status, o sistema enviará uma notificação para o endereço fornecido pelo cliente, informando a atualização.

A URL que receberá as notificações deverá ser informada através do endpoint Cadastrar/Alterar Webhook.

Fazendo Requisição

A notificação será enviada utilizando o método POST, e espera uma resposta do tipo HTTP 200.

Segue estrutura do JSON enviado como request body:

{
  "notification_type": "card_payment",
  "message": {
    "muid": "c9a2f8d1-6d4e-4e83-9b42-8c39bfa12345",
    "rrn": "123456789012",
    "amount": 25990,
    "currency": "BRL",
    "status": "accepted",
    "last_digits": "4821",
    "installments": 3,
    "tracking_number": "TRX-20250930-001",
    "card_holder_name": "João Silva",
    "card_holder_email": "joao.silva@example.com",
    "card_holder_document": "123.456.789-00",
    "brand": "VISA",
    "request_token": "tok_7f2b91c3e8ab4a7fa8f39f123456",
    "payment_type": "credit",
    "authorization_code": "AUTH987654",
    "first_digits": "411111",
    "active": true,
    "slug_authorizer": "stone",
    "slug_customer": "customer_001",
    "slug_terminal": "terminal_123",
    "slug_merchant": "merchant_456",
    "sales_channel": "ecommerce",
    "authorizer_merchant_id": "MRC123456",
    "authorizer_terminal_id": "TERM7890",
    "transaction_status": "authorized",
    "product_or_issuer": "Banco XPTO",
    "settlement_management_type": "automatic",
    "transaction_method": "cnp",
    "cancelling": false,
    "created_at": "2025-09-30T17:45:12Z",
    "updated_at": "2025-09-30T17:46:00Z"
  },
  "md5": "679f3ff14b8eadd1e504f2a35c0d8fb3"
}

OBS: Para gerar o hash md5 da mensagem é necessário considerar o seguinte formato da STRING a ser codificada.

STRING

    card_payment.{muid}.{end_to_end}.{rrn}.{amount}.{secret_key}

Onde:

card_payment: palavra card_payment escrita em minúsculo
{muid}: Identificador único da transação
{rrn}:Retrieval Reference Number (referência do adquirente/banco)
{amount}: Valor em centavos
{secret_key}: Chave única, exclusiva do cliente para gerar hash. Ela é gerada solicitando a criação de Hash MD5 para a conta.

A string abaixo deve ser montada para gerar o Hash MD5 da mensagem citada como exemplo acima, considerando que a chave secreta do cliente seja a palavra SECRETKEY:

STRING - Exemplo

    card_payment.7c2cb2e0a9004a8893358b1dd7ae5b1d.999999999999.1000.SECRETKEY

Erro

Caso seja obtido um resultado diferente de 200, o sistema tentará enviar pelos próximos 10 minutos, a cada minuto enquanto não for obtido um resultado de sucesso.

O erro persistindo nas 10 tentativas, a notificação será marcada como cancelada no sistema e nossa equipe entrará em contato para averiguar quaisquer problemas de integração.

Observação

O reenvio de notificações após a primeira tentativa falha ocorrerá apenas em ambiente de produção.

Descrição dos Atributos

PARÂMETRO	TIPO	DESCRIÇÃO	OBRIGATÓRIO
`notification_type`	STRING	Indica o tipo de mensagem transmitida(Limite 25 caracteres)	Sim
`message`	OBJECT	Objeto CardPayment atualizado, conforme apresentado pelo endpoint Cartão → Buscar Pagamento	Sim
`md5`	STRING	Hash md5 para autenticação da notificação	NÃO