Inclusão de novo campo MAC - Merchant Advice Code
GuidesSuporteAPI Reference

Inclusão de novo campo MAC - Merchant Advice Code

A Mastercard fornecerá um novo recurso chamado MAC - Merchant Advice Code para auxiliar na gestão de tentativas de pagamento não autorizadas.

Esse código adicional complementa o código de recusa da Abecs e orienta sobre quando as transações podem ser tentadas novamente após uma recusa ou se a recusa é definitiva.

Este novo campo na response será implementado a partir do dia XX de Novembro de 2023.

❗️

Campo exclusivo para clientes no modelo Gateway

Formatos do campo

No Pagar.me, incluímos o objeto retry_info nas respostas de autorização, o qual fornecerá informações específicas com base na adquirente utilizada durante a autorização da transação.

Adquirentes Rede, PagSeguro, Cielo, SafraPay e Getnet

Foi implementado o campo brand_failure_return_code, que retornará o código MAC enviado pela bandeira (consultar tabela abaixo):

Código MACDescriçãoClassificação
1Informações atualizadas/adicionais necessáriasReversível
2Tente novamente mais tardeReversível
3Não Tente NovamenteIrreversível
4Requisitos de token não atendidos para este tipo de tokenReversível
21Cancelamento de PagamentoIrreversível
24Tente após 1 hora (Válido somente para o código de resposta 51 (insuficiência de fundos)Reversível
25Tente após 24 horas (Válido somente para o código de resposta 51 (insuficiência de fundos)Reversível
26Tente após 2 dias (Válido somente para o código de resposta 51 (insuficiência de fundos)Reversível
27Tente após 4 dias (Válido somente para o código de resposta 51 (insuficiência de fundos)Reversível
28Tente após 6 dias (Válido somente para o código de resposta 51 (insuficiência de fundos)Reversível
29Tente após 8 dias (Válido somente para o código de resposta 51 (insuficiência de fundos)Reversível
30Tente após 10 dias (Válido somente para o código de resposta 51 (insuficiência de fundos)Reversível

Adquirente Stone

Foram implementados dois campos:

  • transaction_date_limit: indica a quantidade de vezes possíveis de retentar uma transação
  • transaction_limit: indica a data limite para que uma transação seja retentada

É importante se atentar e se adequar a essas regras, pois, elas são passíveis de multa através do programa de multas por excesso de retentativa das bandeiras.

📘

Diferenças entre adquirentes

Caso a a adquirente da transação seja a Rede, Cielo, PagSeguro, SafraPay ou Getnet o objeto retry_info poderá ter o campo brand_failure_return_code preenchido e os campos transaction_date_limit e transaction_limit virão como null.

Caso a a adquirente da transação seja a Stone o objeto retry_info poderá ter os campos transaction_date_limit e transaction_limit preenchidos e o campo brand_failure_return_code como null.

{
    "id": "or_rB3nlw7IPIjlKo5a",
    "code": "ZQ6VSNS1R6",
    "amount": 2990,
    "currency": "BRL",
    "closed": true,
    "items": [
        {
            "id": "oi_1jVBNW8HdHzAwMRp",
            "type": "product",
            "description": "Chaveiro do Tesseract",
            "amount": 2990,
            "quantity": 1,
            "status": "active",
            "created_at": "2023-09-27T05:33:33Z",
            "updated_at": "2023-09-27T05:33:33Z",
            "code": "123"
        }
    ],
    "customer": {
        "id": "cus_Rr1dD3PUdUbyWkOw",
        "name": "Tony Stark",
        "email": "[email protected]",
        "document": "03154435026",
        "document_type": "cpf",
        "type": "individual",
        "delinquent": false,
        "address": {
            "id": "addr_06Lp2JKIRsBnpBrN",
            "line_1": "7221, Avenida Dra Ruth Cardoso, Pinheiro",
            "line_2": "Prédio",
            "zip_code": "05425070",
            "city": "São Paulo",
            "state": "SP",
            "country": "BR",
            "status": "active",
            "created_at": "2023-03-07T13:05:01Z",
            "updated_at": "2023-03-07T13:05:01Z"
        },
        "created_at": "2022-05-03T17:27:55Z",
        "updated_at": "2023-09-27T05:33:33Z",
        "birthdate": "1993-01-09T00:00:00Z",
        "phones": {
            "home_phone": {
                "country_code": "55",
                "number": "000000000",
                "area_code": "21"
            },
            "mobile_phone": {
                "country_code": "55",
                "number": "000000000",
                "area_code": "11"
            }
        },
        "metadata": {
            "classificação": "Cliente VIP"
        }
    },
    "status": "paid",
    "created_at": "2023-09-27T05:33:33Z",
    "updated_at": "2023-09-27T05:33:34Z",
    "closed_at": "2023-09-27T05:33:33Z",
    "charges": [
        {
            "id": "ch_WBaVJYesysVJMmZl",
            "code": "ZQ6VSNS1R6",
            "amount": 2990,
            "paid_amount": 2990,
            "status": "paid",
            "currency": "BRL",
            "payment_method": "credit_card",
            "paid_at": "2023-09-27T05:33:34Z",
            "created_at": "2023-09-27T05:33:33Z",
            "updated_at": "2023-09-27T05:33:34Z",
            "customer": {
                "id": "cus_Rr1dD3PUdUbyWkOw",
                "name": "Tony Stark",
                "email": "[email protected]",
                "document": "03154435026",
                "document_type": "cpf",
                "type": "individual",
                "delinquent": false,
                "address": {
                    "id": "addr_06Lp2JKIRsBnpBrN",
                    "line_1": "7221, Avenida Dra Ruth Cardoso, Pinheiro",
                    "line_2": "Prédio",
                    "zip_code": "05425070",
                    "city": "São Paulo",
                    "state": "SP",
                    "country": "BR",
                    "status": "active",
                    "created_at": "2023-03-07T13:05:01Z",
                    "updated_at": "2023-03-07T13:05:01Z"
                },
                "created_at": "2022-05-03T17:27:55Z",
                "updated_at": "2023-09-27T05:33:33Z",
                "birthdate": "1993-01-09T00:00:00Z",
                "phones": {
                    "home_phone": {
                        "country_code": "55",
                        "number": "000000000",
                        "area_code": "21"
                    },
                    "mobile_phone": {
                        "country_code": "55",
                        "number": "000000000",
                        "area_code": "11"
                    }
                },
                "metadata": {
                    "classificação": "Cliente VIP"
                }
            },
            "last_transaction": {
                "operation_key": "127025734",
                "id": "tran_BVqeROeidirYDA8y",
                "transaction_type": "credit_card",
                "gateway_id": "9432b667-193e-4800-8def-0b6f0a6d2250",
                "amount": 2990,
                "status": "captured",
                "success": true,
                "installments": 1,
                "statement_descriptor": "AVENGERS",
                "acquirer_name": "simulator",
                "acquirer_tid": "181872262",
                "acquirer_nsu": "62096",
                "acquirer_auth_code": "584",
                "acquirer_message": "Transação capturada com sucesso",
                "acquirer_return_code": "00",
                "operation_type": "auth_and_capture",
                "card": {
                    "id": "card_aKrVN9ktMtwgl9wE",
                    "first_six_digits": "400000",
                    "last_four_digits": "0010",
                    "brand": "Visa",
                    "holder_name": "Tony Stark",
                    "exp_month": 1,
                    "exp_year": 2025,
                    "status": "active",
                    "type": "credit",
                    "created_at": "2022-09-28T08:10:58Z",
                    "updated_at": "2022-09-28T08:10:58Z",
                    "billing_address": {
                        "zip_code": "90265",
                        "city": "Malibu",
                        "state": "CA",
                        "country": "US",
                        "line_1": "10880, Malibu Point, Malibu Central"
                    }
                },
                "payment_type": "PAN",
                "retry_info": {
                    "brand_failure_return_code": "3",
                    "transaction_date_limit": null,
                    "transaction_limit": null
                },
                "created_at": "2023-09-27T05:33:33Z",
                "updated_at": "2023-09-27T05:33:33Z",
                "gateway_response": {
                    "code": "200",
                    "errors": []
                },
                "antifraud_response": {},
                "metadata": {}
            }
        }
    ],
    "checkouts": []
}