Reprocessar Webhook - Transações

Use esta rota para reprocessar manualmente o envio de um webhook de transação que falhou. O sistema reenviará o webhook com o mesmo payload e headers que foram utilizados na tentativa original.

POSTv3/webhooks/:transaction_id

Request Variable Path

Atributo	Tipo	Descrição
transaction_id	string	ID Marlim da transação.

cuidado

O reprocessamento utiliza o mesmo payload e headers do webhook original. Certifique-se de que o endpoint de destino (webhook_url) está acessível antes de reprocessar.

Retentativas automáticas

Quando o envio de um webhook falha, a Marlim automaticamente agenda retentativas com intervalo de 60 segundos, até um máximo de 10 tentativas. Esta rota permite forçar o reenvio manualmente a qualquer momento, independente do status atual do webhook.

Response Object

Propriedade	Tipo	Descrição
message	string	Mensagem de confirmação do reprocessamento.
transaction_id	string	ID Marlim da transação cujo webhook foi reprocessado.
payload	object	Payload do webhook que foi reenviado ao endpoint de destino.
payload[event]	string	Tipo do evento do webhook. Valores possíveis: transaction_status_changed.
payload[transaction_id]	string	Número identificador da transação na Marlim.
payload[item_id]	string	Número identificador da transação na sua plataforma.
payload[payment_method]	string	Método de pagamento utilizado na transação.
payload[current_status]	string	Status atual da transação. Valores possíveis: paid, review, rejected, refused, failed, refunded, chargedback.
payload[nsu]	string	Número Sequencial Único da transação.
payload[authorization_code]	string	Código de autorização da transação.
payload[date_created]	dateTime	Data de criação da transação no formato ISODateTime.
payload[date_updated]	dateTime	Data de atualização do status da transação no formato ISODateTime.
payload[amount]	int32	Valor em centavos cobrado na transação.
payload[paid_amount]	int32	Valor em centavos capturado na transação.
payload[installments]	string	Número de parcelas em que o cliente pagou.
payload[card_holder_name]	string	Nome do portador do cartão.
payload[card_brand]	string	Bandeira do cartão.
payload[card_first_digits]	string	Primeiros dígitos do cartão.
payload[card_last_digits]	string	Últimos dígitos do cartão.
payload[sub_seller_id]	string	ID do sub-seller associado à transação (quando aplicável).
payload[acquirer_status_code]	string	Código de status retornado pelo adquirente.

Exemplos

Reprocessar com sucesso

Request

curl -X POST "https://api.marlim.co/v3/webhooks/HcDscltTIVK3VMAAOj7J" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d '{}'

Response200

{
  "message": "webhook reprocessed successfully",
  "transaction_id": "HcDscltTIVK3VMAAOj7J",
  "payload": {
    "event": "transaction_status_changed",
    "transaction_id": "HcDscltTIVK3VMAAOj7J",
    "item_id": "ABC123456789",
    "payment_method": "credit_card",
    "current_status": "paid",
    "nsu": "98765432",
    "authorization_code": "112233",
    "date_created": "2026-03-30T23:15:56.420Z",
    "date_updated": "2026-03-30T23:15:56.420Z",
    "amount": 1000,
    "paid_amount": 1000,
    "installments": "1",
    "card_holder_name": "Luke Skywalker",
    "card_brand": "visa",
    "card_first_digits": "444455",
    "card_last_digits": "2222",
    "sub_seller_id": "sub_k4m6Rw5rlQszEY7fiuRe",
    "acquirer_status_code": "0000"
  }
}

Webhook não encontrado

Request

curl -X POST "https://api.marlim.co/v3/webhooks/AABBCCDD" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d '{}'

Response404

{
  "message": "webhook not found"
}

Falha no reenvio

Request

curl -X POST "https://api.marlim.co/v3/webhooks/HcDscltTIVK3VMAAOj7J" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d '{}'

Response400

{
  "errors": {
    "type": "webhook",
    "message": "Failed to dispatch webhook. Please try again later.",
    "doc_url": "https://docs.api.marlim.co/webhooks/transacoes/reprocessar"
  }
}