Cartões de teste

Para testar a integração usando cartões de teste, disponibilizamos uma lista que permite simular diversos cenários em sua aplicação com os recursos da plataforma de APIs Pagbank.

🚧

Chaves de API

Ao testar a integração com cartões de teste, certifique-se de utilizar chaves de API de teste em todas as requisições, tanto para testes interativos de formas de pagamento quanto para testes de programação.

Os cartões de teste podem ser utilizados nos seguintes recursos:

A tabela a seguir apresenta os dados dos cartões de teste, suas respectivas bandeiras e a resposta esperada ao utilizá-los. Além dos dados do cartão, você pode realizar a criptografia dos dados utilizando os botões disponibilizados. Ao usar os botões de criptografia, os dados do cartão criptografado são disponibilizados na sua área de transferência, possibilitando que você cole no lugar desejado de seu código, por exemplo.

Cartão de teste Bandeira Respostas
Número: 4539620659922097
Cód. de Seg.: 123
Data Exp.:12/2026
VISA Autorização bem-sucedida.
Retorna status AUTHORIZED ou PAID.
Número: 4929291898380766
Cód. de Seg.: 123
Data Exp.:12/2026
VISA Autorização negada.
Retorna status DECLINED.
Número: 5240082975622454
Cód. de Seg.: 123
Data Exp.:12/2026
MASTERCARD Autorização bem-sucedida.
Retorna status AUTHORIZED ou PAID.
Número: 5530062640663264
Cód. de Seg.: 123
Data Exp.:12/2026
MASTERCARD Autorização negada.
Retorna status DECLINED.
Número: 345817690311361
Cód. de Seg.: 1234
Data Exp.:12/2026
AMERICAN EXPRESS Autorização bem-sucedida.
Retorna status AUTHORIZED ou PAID.
Número: 372938001199778
Cód. de Seg.: 1234
Data Exp.:12/2026
AMERICAN EXPRESS Autorização negada.
Retorna status DECLINED.
Número: 4514161122113757
Cód. de Seg.: 123
Data Exp.:12/2026
ELO Autorização bem-sucedida.
Retorna status AUTHORIZED ou PAID.
Número: 4389350446134811
Cód. de Seg.: 123
Data Exp.:12/2026
ELO Autorização negada.
Retorna status DECLINED.
Número: 6062828598919021
Cód. de Seg.: 123
Data Exp.:12/2026
HIPER Autorização bem-sucedida.
Retorna status AUTHORIZED ou PAID.
Número: 6062822916014409
Cód. de Seg.: 123
Data Exp.:12/2026
HIPER Autorização negada.
Retorna status DECLINED.

🚧

Números fictícios

Todos os números de cartões de créditos na tabela são fictícios e não devem ser utilizados no ambiente Produção.

Exemplos de request e response

Autorização bem-sucedida

curl --location --request POST 'https://sandbox.api.pagseguro.com/charges' \
--header 'Authorization: {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "reference_id": "ex-00001",
  "description": "Motivo do pagamento",
  "amount": {
    "value": 1000,
    "currency": "BRL"
  },
  "payment_method": {
    "type": "CREDIT_CARD",
    "installments": 1,
    "capture": false,
    "card": {
      "number": "4539620659922097",
      "exp_month": "03",
      "exp_year": "2026",
      "security_code": "123",
      "holder": {
        "name": "Jose da Silva"
      }
    }
  }
}'
{
  "id": "CHAR_2FC1A976-8DA8-4011-9AA0-2FB9D941CD46",
  "reference_id": "ex-00001",
  "status": "AUTHORIZED",
  "created_at": "2022-04-28T14:54:05.007-03:00",
  "description": "Motivo do pagamento",
  "amount": {
    "value": 1000,
    "currency": "BRL",
    "summary": {
      "total": 1000,
      "paid": 0,
      "refunded": 0
    }
  },
  "payment_response": {
    "code": "20000",
    "message": "SUCESSO",
    "reference": "032416400102"
  },
  "payment_method": {
    "type": "CREDIT_CARD",
    "installments": 1,
    "capture": false,
    "capture_before": "2022-05-03T14:54:08.434-03:00",
    "card": {
      "brand": "visa",
      "first_digits": "453962",
      "last_digits": "2097",
      "exp_month": "3",
      "exp_year": "2026",
      "holder": {
        "name": "Jose da Silva"
      }
    },
    "soft_descriptor": "MinhaLLoja"
  },
  "notification_urls": [],
  "links": [
    {
      "rel": "SELF",
      "href": "https://sandbox.api.pagseguro.com/charges/CHAR_2FC1A976-8DA8-4011-9AA0-2FB9D941CD46",
      "media": "application/json",
      "type": "GET"
    },
    {
      "rel": "CHARGE.CANCEL",
      "href": "https://sandbox.api.pagseguro.com/charges/CHAR_2FC1A976-8DA8-4011-9AA0-2FB9D941CD46/cancel",
      "media": "application/json",
      "type": "POST"
    },
    {
      "rel": "CHARGE.CAPTURE",
      "href": "https://sandbox.api.pagseguro.com/charges/CHAR_2FC1A976-8DA8-4011-9AA0-2FB9D941CD46/capture",
      "media": "application/json",
      "type": "POST"
    }
  ]
}

Autorização negada

curl --location --request POST 'https://sandbox.api.pagseguro.com/charges' \
--header 'Authorization: {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "reference_id": "ex-00001",
  "description": "Motivo do pagamento",
  "amount": {
    "value": 1000,
    "currency": "BRL"
  },
  "payment_method": {
    "type": "CREDIT_CARD",
    "installments": 1,
    "capture": false,
    "card": {
      "number": "372938001199778",
      "exp_month": "03",
      "exp_year": "2026",
      "security_code": "1234",
      "holder": {
        "name": "Jose da Silva"
      }
    }
  }
}'
{
  "id": "CHAR_A237E871-0478-4DE0-9151-C0845E862ECD",
  "reference_id": "ex-00001",
  "status": "DECLINED",
  "created_at": "2022-04-28T14:59:50.515-03:00",
  "description": "Motivo do pagamento",
  "amount": {
    "value": 1000,
    "currency": "BRL",
    "summary": {
      "total": 1000,
      "paid": 0,
      "refunded": 0
    }
  },
  "payment_response": {
    "code": "20007",
    "message": "VERIFIQUE OS DADOS DO CARTÃO",
    "reference": "1651168791134"
  },
  "payment_method": {
    "type": "CREDIT_CARD",
    "installments": 1,
    "capture": false,
    "card": {
      "brand": "amex",
      "first_digits": "372938",
      "last_digits": "9778",
      "exp_month": "3",
      "exp_year": "2026",
      "holder": {
        "name": "Jose da Silva"
      }
    },
    "soft_descriptor": "MinhaLLoja"
  },
  "notification_urls": [],
  "links": [
    {
      "rel": "SELF",
      "href": "https://sandbox.api.pagseguro.com/charges/CHAR_A237E871-0478-4DE0-9151-C0845E862ECD",
      "media": "application/json",
      "type": "GET"
    },
    {
      "rel": "CHARGE.CANCEL",
      "href": "https://sandbox.api.pagseguro.com/charges/CHAR_A237E871-0478-4DE0-9151-C0845E862ECD/cancel",
      "media": "application/json",
      "type": "POST"
    }
  ]
}