Consultar Webhook - Transações

Use esta rota para consultar o payload do último webhook que falhou ao ser enviado para uma transação específica. É útil para inspecionar o conteúdo da requisição e auxiliar na identificação e diagnóstico de problemas no envio.

GETv3/webhooks/:transaction_id

Request Variable Path

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

cuidado

É necessário informar o transaction_id que a Marlim retorna nas solicitações de criação de transação.

Response Object

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

Exemplos

Consultar Webhook

Request

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

Response200

{
  "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 GET "https://api.marlim.co/v3/webhooks/AABBCCDD" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d '{}'

Response404

{
  "message": "webhook not found"
}