Simulador de Cartão de Crédito

Oferecemos um ambiente de teste abrangente para simular transações de pagamento via cartão de crédito. Este simulador é uma ferramenta essencial para desenvolvedores e testadores, permitindo que explorem e verifiquem o funcionamento de diferentes tipos de operações de pagamento com cartão de crédito em um cenário controlado e seguro.

🚧
Atenção: Detalhes Importantes
As operações disponíveis no simulador de voucher e débito seguem as mesmas do cartão de crédito, diferenciando-se apenas pelo tipo de pagamento.

Tabela de Cartões para Teste

Ao realizar testes nos cenários apresentados, você deve fornecer o número do cartão correspondente, uma data de validade à expirar, o método de pagamento definido como credit_card e todos os dados adicionais necessários para gerar um novo pedido de pagamento.

Número	Cenário
5408 9323 3885 2495	Transação Aprovada pelo Emissor
5309 2942 9165 9742	Transação Aprovada pelo Emissor
3476 422494 75295	Transação Aprovada pelo Emissor
4916 6764 2466 9416	Recusa pelo Antifraude
5135 0522 4817 5927	Recusa pelo Antifraude
3490 961957 71348	Recusa pelo Antifraude
4556 6886 6457 8178	Análise de Antifraude Concluída com Aceitação
5140 1458 4494 1263	Análise de Antifraude Concluída com Aceitação
3434 420206 95433	Análise de Antifraude Concluída com Aceitação
4485 4274 1634 7111	Análise de Antifraude Concluída com Rejeição
5533 2006 5967 3959	Análise de Antifraude Concluída com Rejeição
3714 536611 63206	Análise de Antifraude Concluída com Rejeição
4485 0356 9739 2282	Análise de Antifraude em Revisão
5101 0007 4903 6536	Análise de Antifraude em Revisão
3420 553334 87644	Análise de Antifraude em Revisão
4532 2418 1581 5930	Transação em Processamento pelo Emissor
5139 8083 5475 5232	Transação em Processamento pelo Emissor
3794 775869 88498	Transação em Processamento pelo Emissor
4485 8885 1924 7120	Transação com Erro de Fundos
5242 6598 1257 1412	Transação com Erro de Fundos
3771 025341 39182	Transação com Erro de Fundos
4916 2008 0511 3447	Transação em Revisão Interna
3702 211701 02390	Transação em Revisão Interna
3797 820640 99738	Transação em Revisão Interna

🚧
Simular um pagamento recusado
Para simular um fluxo de cartão recusado, pode ser utilizado qualquer outro número de cartão, exceto os da listagem da tabela de testes e dos demais cenários da tabela cartões.

Exemplo de Resposta Simulada

O simulador gerará uma resposta similar que imita o retorno da API em produção. O exemplo a seguir ilustra as informações-chave que você pode esperar ao fazer uma solicitação à API

🚧
Atenção ao comportamento do pedido
Cada cenário resultará em um comportamento específico para o pedido, cobrança e transação

{
   "order_id":"order_38CB8096-6259-42FA-A926-16F85F87079A",
   "closed":true,
   "items":[
      {
         "product_id":"I7OX98ZP_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "amount":3000.15,
         "description":"Pesquisa de Débitos - ABC1234",
         "type":"vehicle_debt",
         "status":"active"
      }
   ],
   "customer":{
      "name":"Marcos Silveira",
      "phone":"00000000000",
      "email":"[email protected]",
      "document":"0000000000",
      "address":{
         "zip_code":"07241170",
         "line_1":"Rua Santa Elizabeth",
         "line_2":"Apto 1003 Cond. Vicace",
         "state":"SP",
         "city":"Guarulhos"
      }
   },
   "status":"paid",
   "created_at":"2023-10-27T16:40:25.361Z",
   "updated_at":"2023-10-27T16:40:25.361Z",
   "closed_at":"2023-10-27T16:40:25.361Z",
   "charges":[
      {
         "charge_id":"charge_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "code":"ABC1234-I7OX98ZP",
         "gateway_id":"gateway_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "amount":"3000,15",
         "status":"paid",
         "payment_method":"credit_card",
         "paid_at":"2023-10-27T16:40:25.361Z",
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "last_transaction":{
            "transaction_id":"transaction_3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "transaction_type":"credit_card",
            "gateway_id":"gateway_3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "amount":3000.15,
            "status":"captured",
            "success":true,
            "installments":12,
            "operation_type":"authorize_and_capture",
            "card":{
               "card_id":"card_3fa85f64-5717-4562-b3fc-2c963f66afa6",
               "last_four_digits":"5438",
               "brand":"Mastercard",
               "holder_name":"Marcos Silveira",
               "exp_month":11,
               "exp_year":30,
               "status":"active",
               "created_at":"2023-10-27T16:40:25.361Z",
               "updated_at":"2023-10-27T16:40:25.361Z",
               "billing_address":{
                  "zip_code":"07241170",
                  "line_1":"Rua Santa Elizabeth",
                  "line_2":"Apto 1003 Cond. Vicace",
                  "state":"SP",
                  "city":"Guarulhos"
               }
            },
            "type":"credit"
         },
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "gateway_response":{
            "message":"Pagamento Cartão Pedido D3PI6MZP",
            "code":"MP0001"
         },
         "antifraud_response":{
            "status":"accept",
            "return_code":"",
            "return_message":"",
            "score":0
         }
      }
   ]
}

{
   "order_id":"order_38CB8096-6259-42FA-A926-16F85F87079A",
   "closed":true,
   "items":[
      {
         "product_id":"I7OX98ZP_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "amount":3000.15,
         "description":"Pesquisa de Débitos - ABC1234",
         "type":"vehicle_debt",
         "status":"active"
      }
   ],
   "customer":{
      "name":"Marcos Silveira",
      "phone":"00000000000",
      "email":"[email protected]",
      "document":"0000000000",
      "address":{
         "zip_code":"07241170",
         "line_1":"Rua Santa Elizabeth",
         "line_2":"Apto 1003 Cond. Vicace",
         "state":"SP",
         "city":"Guarulhos"
      }
   },
   "status":"failed",
   "created_at":"2023-10-27T16:40:25.361Z",
   "updated_at":"2023-10-27T16:40:25.361Z",
   "closed_at":"2023-10-27T16:40:25.361Z",
   "charges":[
      {
         "charge_id":"charge_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "code":"ABC1234-I7OX98ZP",
         "gateway_id":"gateway_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "amount":"3000,15",
         "status":"failed",
         "payment_method":"credit_card",
         "paid_at":"2023-10-27T16:40:25.361Z",
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "last_transaction":{
            "transaction_id":"transaction_3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "transaction_type":"credit_card",
            "gateway_id":"gateway_3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "amount":3000.15,
            "status":"not_authorized",
            "success":true,
            "installments":12,
            "operation_type":"authorize_and_capture",
            "card":{
               "card_id":"card_3fa85f64-5717-4562-b3fc-2c963f66afa6",
               "last_four_digits":"5438",
               "brand":"Mastercard",
               "holder_name":"Marcos Silveira",
               "exp_month":11,
               "exp_year":30,
               "status":"active",
               "created_at":"2023-10-27T16:40:25.361Z",
               "updated_at":"2023-10-27T16:40:25.361Z",
               "billing_address":{
                  "zip_code":"07241170",
                  "line_1":"Rua Santa Elizabeth",
                  "line_2":"Apto 1003 Cond. Vicace",
                  "state":"SP",
                  "city":"Guarulhos"
               }
            },
            "type":"credit"
         },
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "gateway_response":{
            "message":"Pagamento Cartão Pedido D3PI6MZP",
            "code":"MP0001"
         },
         "antifraud_response":{
            "status":"accept",
            "return_code":"",
            "return_message":"",
            "score":0
         }
      }
   ]
}

{
   "order_id":"order_38CB8096-6259-42FA-A926-16F85F87079A",
   "closed":true,
   "items":[
      {
         "product_id":"I7OX98ZP_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "amount":3000.15,
         "description":"Pesquisa de Débitos - ABC1234",
         "type":"vehicle_debt",
         "status":"active"
      }
   ],
   "customer":{
      "name":"Marcos Silveira",
      "phone":"00000000000",
      "email":"[email protected]",
      "document":"0000000000",
      "address":{
         "zip_code":"07241170",
         "line_1":"Rua Santa Elizabeth",
         "line_2":"Apto 1003 Cond. Vicace",
         "state":"SP",
         "city":"Guarulhos"
      }
   },
   "status":"failed",
   "created_at":"2023-10-27T16:40:25.361Z",
   "updated_at":"2023-10-27T16:40:25.361Z",
   "closed_at":"2023-10-27T16:40:25.361Z",
   "charges":[
      {
         "charge_id":"charge_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "code":"ABC1234-I7OX98ZP",
         "gateway_id":null,
         "amount":3000.15,
         "status":"failed",
         "payment_method":"credit_card",
         "paid_at":"2023-10-27T16:40:25.361Z",
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "last_transaction":null,
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "gateway_response":{},
         "antifraud_response":{
            "status":"reject",
            "return_code":"",
            "return_message":"",
            "score":0
         }
      }
   ]
}

{
   "order_id":"order_38CB8096-6259-42FA-A926-16F85F87079A",
   "closed":true,
   "items":[
      {
         "product_id":"I7OX98ZP_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "amount":3000.15,
         "description":"Pesquisa de Débitos - ABC1234",
         "type":"vehicle_debt",
         "status":"active"
      }
   ],
   "customer":{
      "name":"Marcos Silveira",
      "phone":"00000000000",
      "email":"[email protected]",
      "document":"0000000000",
      "address":{
         "zip_code":"07241170",
         "line_1":"Rua Santa Elizabeth",
         "line_2":"Apto 1003 Cond. Vicace",
         "state":"SP",
         "city":"Guarulhos"
      }
   },
   "status":"failed",
   "created_at":"2023-10-27T16:40:25.361Z",
   "updated_at":"2023-10-27T16:40:25.361Z",
   "closed_at":"2023-10-27T16:40:25.361Z",
   "charges":[
      {
         "charge_id":"charge_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "code":"ABC1234-I7OX98ZP",
         "gateway_id":null,
         "amount":3000.15,
         "status":"failed",
         "payment_method":"credit_card",
         "paid_at":"2023-10-27T16:40:25.361Z",
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "last_transaction":null,
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "gateway_response":{},
         "antifraud_response":{
            "status":"review",
            "return_code":"",
            "return_message":"",
            "score":0
         }
      }
   ]
}

Transação Aprovada pelo Emissor do Cartão

Aqui será descrito o comportamento esperado no ambiente simulado da Zapay quando um Pedido de Pagamento é processado com a intenção de ser autorizado e capturado authorize_and_capture.

📘
Comportamento esperado utilizando um cartão válido
Ao utilizar um cartão válido para o cenário, o simulador retornará uma resposta indicando que a transação foi aprovada pelo emissor do cartão.

Comportamento das Entidade

Entidade: Pedido (`order`)

Um pedido de pagamento feito com um cartão válido registra todas as informações necessárias e muda para o status paid após a transação.

📘
Comportamento com Multimeios: Pagamentos com Dois Cartões
Ao simular um cenário de um pagamento que envolve dois cartões, é importante que ambos cartões sejam válidos para o cenário.
Saiba mais sobre a funcionalidade de multimeios aqui.

Entidade: Cobrança (`charge`)

A criação de um pedido gera uma ou mais cobranças vinculadas, refletindo o valor do pedido. Por fim muda para o status paid após a transação.

🚧
Comportamento com Multimeios: Pagamentos com Dois Cartões
Em caso de um cenário que envolva multimeios, serão geradas uma cobrança para cada meio de pagamento informado.

Entidade: Transação (`transaction`)

Autorizar e Capturar: Ao enviar um pagamento com cartão de crédito credit_card com o tipo de operação authorize_and_capture, simulamos a verificação que determina a validade do método de pagamento e todo o processo que segue para à transferencia dos recursos autorizados da conta do cliente.

🚧
Autorização com captura automática
O tipo de operação authorize_and_capture indica que a transação da cobrança deve ser autorizada e depois capturada.

Apenas Autorizar: Ao enviar um pagamento com cartão de crédito credit_card com o tipo de operação authorize_only, simulamos a verificação que determina a validade do método de pagamento.

🚧
Autorização com captura posterior
O tipo de operação authorize_only indica que a transação da cobrança será apenas autorizada (Passar pela analise de risco, antifraude, escolha de adquirente e obter a autorização e posteriormente será realizada a captura da cobrança ou não).

❗️
Atenção: Cenários assíncronos
Cenários assíncronos exigem ação adicional para capturar pagamentos autorizados. Ao seguir este cenário simulado, será necessário realizar uma solicitação para capturar o pagamento e posterior obter a resposta do pedido aprovado pelo emissor.
Ao realizar verificação do pedido, encontraremos o pedido com status pending, a cobrança aguardando o pagamento, portanto com status pending e a transação com status authorized_pending_capture indicando que a mesma foi autorizada, mas os fundos ainda não foram capturados. Descubra aqui como realizar uma captura de um pagamento autorizado.

Comportamento Esperado

Após uma transação bem-sucedida, o ambiente simulado refletirá as mudanças de estado apropriadas a suas entidades:

{
   "order_id":"order_38CB8096-6259-42FA-A926-16F85F87079A",
   "closed":true,
   "items":[
      {
         "product_id":"I7OX98ZP_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "amount":3000.15,
         "description":"Pesquisa de Débitos - ABC1234",
         "type":"vehicle_debt",
         "status":"active"
      }
   ],
   "customer":{
      "name":"Marcos Silveira",
      "phone":"00000000000",
      "email":"[email protected]",
      "document":"0000000000",
      "address":{
         "zip_code":"07241170",
         "line_1":"Rua Santa Elizabeth",
         "line_2":"Apto 1003 Cond. Vicace",
         "state":"SP",
         "city":"Guarulhos"
      }
   },
   "status":"paid",
   "created_at":"2023-10-27T16:40:25.361Z",
   "updated_at":"2023-10-27T16:40:25.361Z",
   "closed_at":"2023-10-27T16:40:25.361Z",
   "charges":[
      {
         "charge_id":"charge_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "code":"ABC1234-I7OX98ZP",
         "gateway_id":"gateway_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "amount":"3000,15",
         "status":"paid",
         "payment_method":"credit_card",
         "paid_at":"2023-10-27T16:40:25.361Z",
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "last_transaction":{
            "transaction_id":"transaction_3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "transaction_type":"credit_card",
            "gateway_id":"gateway_3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "amount":3000.15,
            "status":"captured",
            "success":true,
            "installments":12,
            "operation_type":"authorize_and_capture",
            "card":{
               "card_id":"card_3fa85f64-5717-4562-b3fc-2c963f66afa6",
               "last_four_digits":"5438",
               "brand":"Mastercard",
               "holder_name":"Marcos Silveira",
               "exp_month":11,
               "exp_year":30,
               "status":"active",
               "created_at":"2023-10-27T16:40:25.361Z",
               "updated_at":"2023-10-27T16:40:25.361Z",
               "billing_address":{
                  "zip_code":"07241170",
                  "line_1":"Rua Santa Elizabeth",
                  "line_2":"Apto 1003 Cond. Vicace",
                  "state":"SP",
                  "city":"Guarulhos"
               }
            },
            "type":"credit"
         },
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "gateway_response":{
            "message":"Pagamento Cartão Pedido D3PI6MZP",
            "code":"MP0001"
         },
         "antifraud_response":{
            "status":"accept",
            "return_code":"",
            "return_message":"",
            "score":0
         }
      }
   ]
}

Transação Recusada pelo Emissor do Cartão

Aqui será descrito o comportamento esperado no ambiente simulado da Zapay quando um Pedido de Pagamento é recusado independente das credenciais do cartão serem inseridas corretamente ou da cobertura de fundos disponível.

❗️
Comportamento esperado utilizando um cartão válido
Ao utilizar um cartão válido para o cenário, o simulador retornará uma resposta indicando que a transação foi recusada pelo emissor do cartão. Este resultado pode ocorrer por diversos motivos, tais como políticas internas do emissor, suspeita de fraude ou restrições de segurança.

Comportamento das Entidades

Entidade: Pedido (`order`)

Um pedido de pagamento feito com um cartão de falha, registra todas as informações necessárias e muda para o status failed após a transação.

📘
Comportamento com Multimeios: Pagamentos com Dois Cartões
Ao simular um cenário de um pagamento que envolve dois cartões, é importante que ambos cartões sejam válidos para o cenário,
Saiba mais sobre a funcionalidade de multimeios aqui.

Entidade: Cobrança (`charge`)

A criação de um pedido gera uma ou mais cobranças vinculadas, refletindo o valor do pedido. Por fim muda para o status failed após a transação.

🚧
Comportamento com Multimeios: Pagamentos com Dois Cartões
Em caso de um cenário que envolva multimeios, serão geradas uma cobrança para cada meio de pagamento informado. Ambas cobranças ficaram com status failed se ambos cartões forem válidos para o cenário.

Entidade: Transação (`transaction`)

Ao enviar um pagamento com cartão de crédito credit_card independente do tipo de operação. Indicaremos que a transação não foi autorizada e, portanto, não foi aprovada. Isso geralmente indica uma falha na autorização do pagamento.

❗️
Atenção: Cenários assíncronos
Ao realizar verificação do pedido, encontraremos o pedido com status failed, a cobrança aguardando o pagamento, portanto com status failed e a transação com status not_authorized indicando que a mesma não foi autorizada pelo emissor do cartão.

Comportamento Esperado

Após uma transação bem-sucedida, o ambiente simulado refletirá as mudanças de estado apropriadas a suas entidades:

{
   "order_id":"order_38CB8096-6259-42FA-A926-16F85F87079A",
   "closed":true,
   "items":[
      {
         "product_id":"I7OX98ZP_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "amount":3000.15,
         "description":"Pesquisa de Débitos - ABC1234",
         "type":"vehicle_debt",
         "status":"active"
      }
   ],
   "customer":{
      "name":"Marcos Silveira",
      "phone":"00000000000",
      "email":"[email protected]",
      "document":"0000000000",
      "address":{
         "zip_code":"07241170",
         "line_1":"Rua Santa Elizabeth",
         "line_2":"Apto 1003 Cond. Vicace",
         "state":"SP",
         "city":"Guarulhos"
      }
   },
   "status":"failed",
   "created_at":"2023-10-27T16:40:25.361Z",
   "updated_at":"2023-10-27T16:40:25.361Z",
   "closed_at":"2023-10-27T16:40:25.361Z",
   "charges":[
      {
         "charge_id":"charge_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "code":"ABC1234-I7OX98ZP",
         "gateway_id":"gateway_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "amount":"3000,15",
         "status":"failed",
         "payment_method":"credit_card",
         "paid_at":"2023-10-27T16:40:25.361Z",
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "last_transaction":{
            "transaction_id":"transaction_3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "transaction_type":"credit_card",
            "gateway_id":"gateway_3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "amount":3000.15,
            "status":"not_authorized",
            "success":true,
            "installments":12,
            "operation_type":"authorize_and_capture",
            "card":{
               "card_id":"card_3fa85f64-5717-4562-b3fc-2c963f66afa6",
               "last_four_digits":"5438",
               "brand":"Mastercard",
               "holder_name":"Marcos Silveira",
               "exp_month":11,
               "exp_year":30,
               "status":"active",
               "created_at":"2023-10-27T16:40:25.361Z",
               "updated_at":"2023-10-27T16:40:25.361Z",
               "billing_address":{
                  "zip_code":"07241170",
                  "line_1":"Rua Santa Elizabeth",
                  "line_2":"Apto 1003 Cond. Vicace",
                  "state":"SP",
                  "city":"Guarulhos"
               }
            },
            "type":"credit"
         },
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "gateway_response":{
            "message":"Pagamento Cartão Pedido D3PI6MZP",
            "code":"MP0001"
         },
         "antifraud_response":{
            "status":"accept",
            "return_code":"",
            "return_message":"",
            "score":0
         }
      }
   ]
}

Transação Recusada pelo Antifraude

Aqui será descrito o comportamento esperado no ambiente simulado da Zapay quando um Pedido de Pagamento é recusado pelo antifraude.

❗️
Comportamento esperado utilizando um cartão válido
Ao utilizar um cartão válido para o cenário, o simulador retornará uma resposta indicando que a transação foi recusada pelo antifraude. Este resultado pode ocorrer por diversos motivos, tais como; informações inconsistentes, comportamento suspeito, histórico de fraude, localização geográfica incompatível, uso de dispositivos anônimos, atividade incomum de compra, detalhes de cartão inválidos ou padrões de uso atípicos.

Comportamento das Entidades

Entidade: Pedido (`order`)

Um pedido de pagamento feito com um cartão de falha, registra todas as informações necessárias e muda para o status failed após a transação.

🚧
Comportamento do Pedido: Recusa pelo Antifraude
Ao ocorrer a recusa pelo antifraude , poderemos observar que o objeto **antifraud_response** estará com status reject . Indicando que a análise de antifraude foi concluída, e a transação foi considerada arriscada ou suspeita, portanto, foi rejeitada.

📘
Comportamento com Multimeios: Pagamentos com Dois Cartões
Ao simular um cenário de um pagamento que envolve dois cartões, é importante que ambos cartões sejam válidos para o cenário,.
Saiba mais sobre a funcionalidade de multimeios aqui.

Entidade: Cobrança (`charge`)

A criação de um pedido gera uma ou mais cobranças vinculadas, refletindo o valor do pedido. Por fim muda para o status failed após a transação.

🚧
Comportamento com Multimeios: Pagamentos com Dois Cartões
Em caso de um cenário que envolva multimeios, serão geradas uma cobrança para cada meio de pagamento informado. Ambas cobranças ficaram com status failed se ambos cartões forem válidos para o cenário.

Entidade: Transação (`transaction`)

Ao enviar um pagamento com cartão de crédito credit_card independente do tipo de operação. Indicaremos que a transação foi recusada pelo antifraude, e portanto, não foi aprovada. Isso geralmente indica uma falha na transação do pagamento.

❗️
Atenção: Cenários assíncronos
Ao realizar verificação do pedido, encontraremos o pedido com status failed , a cobrança aguardando o pagamento, portanto com status failed e a transação com status failed indicando que a mesma não pôde ser processada com sucesso.

Comportamento Esperado

Após uma transação mau-sucedida, o ambiente simulado refletirá as mudanças de estado apropriadas a suas entidades:

{
   "order_id":"order_38CB8096-6259-42FA-A926-16F85F87079A",
   "closed":true,
   "items":[
      {
         "product_id":"I7OX98ZP_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "amount":3000.15,
         "description":"Pesquisa de Débitos - ABC1234",
         "type":"vehicle_debt",
         "status":"active"
      }
   ],
   "customer":{
      "name":"Marcos Silveira",
      "phone":"00000000000",
      "email":"[email protected]",
      "document":"0000000000",
      "address":{
         "zip_code":"07241170",
         "line_1":"Rua Santa Elizabeth",
         "line_2":"Apto 1003 Cond. Vicace",
         "state":"SP",
         "city":"Guarulhos"
      }
   },
   "status":"failed",
   "created_at":"2023-10-27T16:40:25.361Z",
   "updated_at":"2023-10-27T16:40:25.361Z",
   "closed_at":"2023-10-27T16:40:25.361Z",
   "charges":[
      {
         "charge_id":"charge_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "code":"ABC1234-I7OX98ZP",
         "gateway_id":null,
         "amount":3000.15,
         "status":"failed",
         "payment_method":"credit_card",
         "paid_at":"2023-10-27T16:40:25.361Z",
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "last_transaction":null,
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "gateway_response":{},
         "antifraud_response":{
            "status":"reject",
            "return_code":"",
            "return_message":"",
            "score":0
         }
      }
   ]
}

Transação em Analise pelo Antifraude

Aqui será descrito o comportamento esperado no ambiente simulado da Zapay quando um Pedido de Pagamento vai para uma analise manual.

❗️
Comportamento esperado utilizando um cartão válido
Ao utilizar um cartão válido para o cenário, o simulador retornará uma resposta indicando que a transação foi para uma analise manual do antifraude. No mundo real isso indicaria que um especialista de risco da Zapay irá conduzir uma avaliação detalhada.

🚧
Comportamento Adicional do Pedido: Em analise pelo Antifraude
Para simular aprovação do risco após analise manual, será necessário reenviar o pedido de pagamento.

Comportamento das Entidades

Entidade: Pedido (`order`)

Um pedido de pagamento feito com um cartão de sucesso, registra todas as informações necessárias e muda para o status failed após a transação. Após o reenvio o pedido mudará para o status paid .

🚧
Comportamento do Pedido: Em analise pelo Antifraude
Ao entrar em analise manual pelo antifraude , poderemos observar que o objeto antifraud_response estará com status review. Indicando que à análise de risco identificou características suspeitas na transação, e, por isso, a transação foi colocada em revisão para uma análise adicional, a fim de determinar sua segurança.

📘
Comportamento com Multimeios: Pagamentos com Dois Cartões
Ao simular um cenário de um pagamento que envolve dois cartões, é importante que ambos cartões sejam válidos para o cenário.
Saiba mais sobre a funcionalidade de multimeios aqui.

Entidade: Cobrança (`charge`)

A criação de um pedido gera uma ou mais cobranças vinculadas, refletindo o valor do pedido. Por fim muda para o status failed após a transação. Após o reenvio a cobrança mudará para o status paid .

🚧
Comportamento com Multimeios: Pagamentos com Dois Cartões
Em caso de um cenário que envolva multimeios, serão geradas uma cobrança para cada meio de pagamento informado.
Ambas cobranças ficaram com status failed se ambos cartões forem válidos para o cenário.

Entidade: Transação (`transaction`)

Ao enviar um pagamento com cartão de crédito credit_card independente do tipo de operação. Indicaremos que a transação entrou em analise manual do antifraude, e portanto, não foi aprovada. Isso geralmente indica uma falha na transação do pagamento. Após o reenvio transação mudará para o status captured .

❗️
Atenção: Cenários assíncronos
No segundo momento, ao realizar verificação do pedido, encontraremos o pedido com status paid, a cobrança aguardando o pagamento, portanto com status paid e a transação com status captured indicando que a mesma não pôde ser processada com sucesso.

Comportamento Esperado

Após uma transação mau-sucedida o ambiente simulado refletirá as mudanças de estado apropriadas a suas entidades:

{
   "order_id":"order_38CB8096-6259-42FA-A926-16F85F87079A",
   "closed":true,
   "items":[
      {
         "product_id":"I7OX98ZP_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "amount":3000.15,
         "description":"Pesquisa de Débitos - ABC1234",
         "type":"vehicle_debt",
         "status":"active"
      }
   ],
   "customer":{
      "name":"Marcos Silveira",
      "phone":"00000000000",
      "email":"[email protected]",
      "document":"0000000000",
      "address":{
         "zip_code":"07241170",
         "line_1":"Rua Santa Elizabeth",
         "line_2":"Apto 1003 Cond. Vicace",
         "state":"SP",
         "city":"Guarulhos"
      }
   },
   "status":"failed",
   "created_at":"2023-10-27T16:40:25.361Z",
   "updated_at":"2023-10-27T16:40:25.361Z",
   "closed_at":"2023-10-27T16:40:25.361Z",
   "charges":[
      {
         "charge_id":"charge_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "code":"ABC1234-I7OX98ZP",
         "gateway_id":null,
         "amount":3000.15,
         "status":"failed",
         "payment_method":"credit_card",
         "paid_at":"2023-10-27T16:40:25.361Z",
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "last_transaction":null,
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "gateway_response":{},
         "antifraud_response":{
            "status":"review",
            "return_code":"",
            "return_message":"",
            "score":0
         }
      }
   ]
}

{
   "order_id":"order_38CB8096-6259-42FA-A926-16F85F87079A",
   "closed":true,
   "items":[
      {
         "product_id":"I7OX98ZP_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "amount":3000.15,
         "description":"Pesquisa de Débitos - ABC1234",
         "type":"vehicle_debt",
         "status":"active"
      }
   ],
   "customer":{
      "name":"Marcos Silveira",
      "phone":"00000000000",
      "email":"[email protected]",
      "document":"0000000000",
      "address":{
         "zip_code":"07241170",
         "line_1":"Rua Santa Elizabeth",
         "line_2":"Apto 1003 Cond. Vicace",
         "state":"SP",
         "city":"Guarulhos"
      }
   },
   "status":"paid",
   "created_at":"2023-10-27T16:40:25.361Z",
   "updated_at":"2023-10-27T16:40:25.361Z",
   "closed_at":"2023-10-27T16:40:25.361Z",
   "charges":[
      {
         "charge_id":"charge_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "code":"ABC1234-I7OX98ZP",
         "gateway_id":"gateway_3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "amount":"3000,15",
         "status":"paid",
         "payment_method":"credit_card",
         "paid_at":"2023-10-27T16:40:25.361Z",
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "last_transaction":{
            "transaction_id":"transaction_3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "transaction_type":"credit_card",
            "gateway_id":"gateway_3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "amount":3000.15,
            "status":"captured",
            "success":true,
            "installments":12,
            "operation_type":"authorize_and_capture",
            "card":{
               "card_id":"card_3fa85f64-5717-4562-b3fc-2c963f66afa6",
               "last_four_digits":"5438",
               "brand":"Mastercard",
               "holder_name":"Marcos Silveira",
               "exp_month":11,
               "exp_year":30,
               "status":"active",
               "created_at":"2023-10-27T16:40:25.361Z",
               "updated_at":"2023-10-27T16:40:25.361Z",
               "billing_address":{
                  "zip_code":"07241170",
                  "line_1":"Rua Santa Elizabeth",
                  "line_2":"Apto 1003 Cond. Vicace",
                  "state":"SP",
                  "city":"Guarulhos"
               }
            },
            "type":"credit"
         },
         "created_at":"2023-10-27T16:40:25.361Z",
         "updated_at":"2023-10-27T16:40:25.361Z",
         "gateway_response":{
            "message":"Pagamento Cartão Pedido D3PI6MZP",
            "code":"MP0001"
         },
         "antifraud_response":{
            "status":"accept",
            "return_code":"",
            "return_message":"",
            "score":0
         }
      }
   ]
}

🚧Atenção: Detalhes Importantes

Tabela de Cartões para Teste

🚧Simular um pagamento recusado

Exemplo de Resposta Simulada

🚧Atenção ao comportamento do pedido

Transação Aprovada pelo Emissor do Cartão

📘Comportamento esperado utilizando um cartão válido

Comportamento das Entidade

Entidade: Pedido (order)

📘Comportamento com Multimeios: Pagamentos com Dois Cartões

Entidade: Cobrança (charge)

🚧Comportamento com Multimeios: Pagamentos com Dois Cartões

Entidade: Transação (transaction)

🚧Autorização com captura automática

🚧Autorização com captura posterior

❗️Atenção: Cenários assíncronos

Comportamento Esperado

Transação Recusada pelo Emissor do Cartão

❗️Comportamento esperado utilizando um cartão válido

Comportamento das Entidades

Entidade: Pedido (order)

📘Comportamento com Multimeios: Pagamentos com Dois Cartões

Entidade: Cobrança (charge)

🚧Comportamento com Multimeios: Pagamentos com Dois Cartões

Entidade: Transação (transaction)

❗️Atenção: Cenários assíncronos

Comportamento Esperado

Transação Recusada pelo Antifraude

❗️Comportamento esperado utilizando um cartão válido

Comportamento das Entidades

Entidade: Pedido (order)

🚧Comportamento do Pedido: Recusa pelo Antifraude

📘Comportamento com Multimeios: Pagamentos com Dois Cartões

Entidade: Cobrança (charge)

🚧Comportamento com Multimeios: Pagamentos com Dois Cartões

Entidade: Transação (transaction)

❗️Atenção: Cenários assíncronos

Comportamento Esperado

Transação em Analise pelo Antifraude

❗️Comportamento esperado utilizando um cartão válido

🚧Comportamento Adicional do Pedido: Em analise pelo Antifraude

Comportamento das Entidades

Entidade: Pedido (order)

🚧Comportamento do Pedido: Em analise pelo Antifraude

📘Comportamento com Multimeios: Pagamentos com Dois Cartões

Entidade: Cobrança (charge)

🚧Comportamento com Multimeios: Pagamentos com Dois Cartões

Entidade: Transação (transaction)

❗️Atenção: Cenários assíncronos

Comportamento Esperado

🚧
Atenção: Detalhes Importantes

🚧
Simular um pagamento recusado

🚧
Atenção ao comportamento do pedido

📘
Comportamento esperado utilizando um cartão válido

Entidade: Pedido (`order`)

📘
Comportamento com Multimeios: Pagamentos com Dois Cartões

Entidade: Cobrança (`charge`)

🚧
Comportamento com Multimeios: Pagamentos com Dois Cartões

Entidade: Transação (`transaction`)

🚧
Autorização com captura automática

🚧
Autorização com captura posterior

❗️
Atenção: Cenários assíncronos

❗️
Comportamento esperado utilizando um cartão válido

Entidade: Pedido (`order`)

📘
Comportamento com Multimeios: Pagamentos com Dois Cartões

Entidade: Cobrança (`charge`)

🚧
Comportamento com Multimeios: Pagamentos com Dois Cartões

Entidade: Transação (`transaction`)

❗️
Atenção: Cenários assíncronos

❗️
Comportamento esperado utilizando um cartão válido

Entidade: Pedido (`order`)

🚧
Comportamento do Pedido: Recusa pelo Antifraude

📘
Comportamento com Multimeios: Pagamentos com Dois Cartões

Entidade: Cobrança (`charge`)

🚧
Comportamento com Multimeios: Pagamentos com Dois Cartões

Entidade: Transação (`transaction`)

❗️
Atenção: Cenários assíncronos

❗️
Comportamento esperado utilizando um cartão válido

🚧
Comportamento Adicional do Pedido: Em analise pelo Antifraude

Entidade: Pedido (`order`)

🚧
Comportamento do Pedido: Em analise pelo Antifraude

📘
Comportamento com Multimeios: Pagamentos com Dois Cartões

Entidade: Cobrança (`charge`)

🚧
Comportamento com Multimeios: Pagamentos com Dois Cartões

Entidade: Transação (`transaction`)

❗️
Atenção: Cenários assíncronos