Docs
get https://gateway.iugu.com/api/v1/transactions/show

Consultar pagamento por order_id ou tid

Consulta o pagamento registrado no Gateway. Quando tid e order_id são enviados juntos, tid tem precedência. Sem nenhum dos dois, retorna 404.

Um pagamento com status nulo e tentativas em transactions foi recusado. Quem distingue a origem é transactions[].lr.source: acquirer para a recusa do adquirente, gateway para a recusa anterior a ele. Nesse segundo caso transactions[].commercial_enterprise vem presente, mas com todos os campos nulos, porque nenhum adquirente chegou a ser escolhido. Em ambos, transactions[].acquirer.status_code traz o código de retorno do motivo.

Pagamentos legados (anteriores ao Gateway) encontrados por tid são retornados com os atributos do registro legado, fora do formato payment_response.

Sem ações implementadas definidas

Request

Query params

order_id

Type: string

Identificador do pedido utilizado na autorização

tid

Type: string

TID da transação retornado pelo adquirente

Headers

Workspace-Id

Type: string

ID do workspace. Quando ausente, é usado o workspace padrão do Gateway.

Ex: 1D81KhKbYuVq9505Bz4Nk9

Response

200

Pagamento encontrado

payment
Object

id
String

status
String
Enum: `authorized`, `charged`, `captured`, `partially_refunded`, `fully_refunded`, ``

Nulo quando nenhuma tentativa foi aprovada pelo adquirente

multi
Array of strings

success_ec
String

ID do estabelecimento que aprovou a transação

mcc
String

recurrent
Boolean

card_on_file
Boolean

tid
String

nsu
String

authorization_code
String

amount_cents
Integer

refunded_amount_cents
Integer

cnpj
String

workspace_id
String

account_id
String

invoice_id
String

`order_id` informado na criação do pagamento

client_ref
String

subscription_id
String

card_id
String

card_bin
String

card_last_four
String

currency
String

installments
Integer

soft_descriptor
String

created_at
String

updated_at
String

transactions
Array of objects

id
String

function
String
Enum: `authorization`, `charge`, `capture`, `cancel`

success
Boolean

tid
String

nsu
String

arp
String

acquirer
Object

payment_id
String

status_code
String

acquirer_mac_code
String

status_description
String

request_status_code
String

request_status_description
String

lr
Object

Código de retorno unificado da tentativa. Vale tanto para a recusa do adquirente quanto para a do próprio Gateway, e é o campo que substituirá `acquirer.status_code`.

code
String

Código de retorno. Da adquirente quando `source` é `acquirer`; do Gateway (`TOK01`, `MCC01`, `DEC01`…) quando é `gateway`. Vem nulo com `source` igual a `acquirer` nas transações anteriores à introdução do campo, em que o código está apenas em `acquirer.status_code`.

source
String
Enum: `acquirer`, `gateway`

Origem do código. `gateway` significa que a transação foi recusada antes de chegar ao adquirente.

card_id
String

card_bin
String

card_last_four
String

card_on_file
Boolean

transaction_token_type
String
Enum: `open`, `acquirer_token`, `network_token`, ``

Tipo de dado de cartão enviado ao adquirente

amount_cents
Integer

ec_group
Object

id
String

name
String

commercial_enterprise
Object

id
String

name
String

number
String

acquirer
String

mcc
Object

id
String

code
String

description
String

created_at
String

anti_fraud
Array of objects

Análises antifraude do pagamento, da mais recente para a mais antiga

id
String

payment_id
String

provider
String

Ex: feedzai

provider_id
String

decision
String

omniscore
String

created_at
String

Example
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
{
  "payment": {
    "id": "<ID>",
    "status": "<STATUS>",
    "multi": [
      "<MULTI>"
    ],
    "success_ec": "<SUCCESS_EC>",
    "mcc": "<MCC>",
    "recurrent": "<RECURRENT>",
    "card_on_file": "<CARD_ON_FILE>",
    "tid": "<TID>",
    "nsu": "<NSU>",
    "authorization_code": "<AUTHORIZATION_CODE>",
    "amount_cents": "<AMOUNT_CENTS>",
    "refunded_amount_cents": "<REFUNDED_AMOUNT_CENTS>",
    "cnpj": "<CNPJ>",
    "workspace_id": "<WORKSPACE_ID>",
    "account_id": "<ACCOUNT_ID>",
    "invoice_id": "<INVOICE_ID>",
    "client_ref": "<CLIENT_REF>",
    "subscription_id": "<SUBSCRIPTION_ID>",
    "card_id": "<CARD_ID>",
    "card_bin": "<CARD_BIN>",
    "card_last_four": "<CARD_LAST_FOUR>",
    "currency": "<CURRENCY>",
    "installments": "<INSTALLMENTS>",
    "soft_descriptor": "<SOFT_DESCRIPTOR>",
    "created_at": "<CREATED_AT>",
    "updated_at": "<UPDATED_AT>",
    "transactions": [
      {
        "id": "<ID>",
        "function": "<FUNCTION>",
        "success": "<SUCCESS>",
        "tid": "<TID>",
        "nsu": "<NSU>",
        "arp": "<ARP>",
        "acquirer": {
          "payment_id": "<PAYMENT_ID>",
          "status_code": "<STATUS_CODE>",
          "acquirer_mac_code": "<ACQUIRER_MAC_CODE>",
          "status_description": "<STATUS_DESCRIPTION>",
          "request_status_code": "<REQUEST_STATUS_CODE>",
          "request_status_description": "<REQUEST_STATUS_DESCRIPTION>"
        },
        "lr": {
          "code": "<CODE>",
          "source": "<SOURCE>"
        },
        "card_id": "<CARD_ID>",
        "card_bin": "<CARD_BIN>",
        "card_last_four": "<CARD_LAST_FOUR>",
        "card_on_file": "<CARD_ON_FILE>",
        "transaction_token_type": "<TRANSACTION_TOKEN_TYPE>",
        "amount_cents": "<AMOUNT_CENTS>",
        "ec_group": {
          "id": "<ID>",
          "name": "<NAME>"
        },
        "commercial_enterprise": {
          "id": "<ID>",
          "name": "<NAME>",
          "number": "<NUMBER>",
          "acquirer": "<ACQUIRER>",
          "mcc": {
            "id": "<ID>",
            "code": "<CODE>",
            "description": "<DESCRIPTION>"
          }
        },
        "created_at": "<CREATED_AT>"
      }
    ],
    "anti_fraud": [
      {
        "id": "<ID>",
        "payment_id": "<PAYMENT_ID>",
        "provider": "feedzai",
        "provider_id": "<PROVIDER_ID>",
        "decision": "<DECISION>",
        "omniscore": "<OMNISCORE>",
        "created_at": "<CREATED_AT>"
      }
    ]
  }
}

401

Não autorizado - Token de autenticação inválido ou ausente

message
String
Enum: `Requires authentication`, `Bad credentials`

Example
1
2
3
{
  "message": "<MESSAGE>"
}

404

`payment_not_found`: Pagamento não encontrado

error
String

Tipo do erro

Ex: payment_not_found

service
String

Nome do serviço que gerou o erro

Ex: Acquirers::CancelService

details
Object

Detalhes adicionais (estrutura varia por tipo de erro)

Example
1
2
3
4
5
6
{
  "error": "payment_not_found",
  "service": "Acquirers::CancelService",
  "details": {
  }
}

500

Erro interno do servidor

error
String

Tipo do erro

Ex: payment_not_found

service
String

Nome do serviço que gerou o erro

Ex: Acquirers::CancelService

details
Object

Detalhes adicionais (estrutura varia por tipo de erro)

Example
1
2
3
4
5
6
{
  "error": "payment_not_found",
  "service": "Acquirers::CancelService",
  "details": {
  }
}