https://gateway.iugu.com/api/v1/transactions/zero_auth
Realizar autorização zero
Realiza uma autorização zero para validar um cartão de crédito. Atualmente apenas via Cielo.
- Um cartão inválido não é um erro HTTP: a resposta é 200 com
Valid: false. - O resultado é armazenado por cartão; consultas seguintes do mesmo cartão retornam o resultado armazenado, sem nova chamada ao adquirente.
Sem ações implementadas definidas
Request
|
Headers |
|
|---|---|
|
Workspace-Id
Type: string ID do workspace. Quando ausente, é usado o workspace padrão do Gateway. Ex: 1D81KhKbYuVq9505Bz4Nk9 |
|
|
Body Required Content Type: application/json |
||||||||
|---|---|---|---|---|---|---|---|---|
|
||||||||
1
2
3
4
5
6
{
"credit_card_id": "<CREDIT_CARD_ID>",
"mcc": "<MCC>",
"cnpj": "<CNPJ>",
"account_id": "<ACCOUNT_ID>"
}
Response
|
200 |
||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
Autorização zero realizada (cartão válido ou inválido)
|
||||||||||
1
2
3
4
5
6
7
{
"Valid": true,
"ReturnCode": "00",
"ReturnMessage": "Transacao autorizada",
"IssuerTransactionId": "580027442382078",
"WorkspaceId": "1D81KhKbYuVq9505Bz4Nk9"
}
|
400 |
||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
Parâmetro obrigatório ausente, com tipo/formato inválido ou não documentado
|
||||||||||
1
2
3
4
5
6
7
{
"error": "<ERROR>",
"error_code": "invalid_sub_merchant_postal_code",
"details": {
"message": "sub_merchant.postal_code format is invalid"
}
}
|
401 |
||
|---|---|---|
|
Não autorizado - Token de autenticação inválido ou ausente
|
||
1
2
3
{
"message": "<MESSAGE>"
}
|
404 |
||||||||
|---|---|---|---|---|---|---|---|---|
|
`credit_card_not_found`: Cartão de crédito não encontrado
|
||||||||
1
2
3
4
5
6
{
"error": "payment_not_found",
"service": "Acquirers::CancelService",
"details": {
}
}
|
500 |
||||||||
|---|---|---|---|---|---|---|---|---|
|
Erro interno. Inclui falhas de roteamento (ex.: `no_ec_group_found`, `no_active_ecs_available`) e rejeições do adquirente (`bad_request`).
|
||||||||
1
2
3
4
5
6
{
"error": "payment_not_found",
"service": "Acquirers::CancelService",
"details": {
}
}