These docs are for v2.2. Click to read the latest docs for v4.1.

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.

Cartão de testeBandeiraRespostas
Número: 4539620659922097
Cód. de Seg.: 123
Data Exp.:12/2026		VISAAutorização bem-sucedida.
Retorna status AUTHORIZED ou PAID.
Número: 4929291898380766
Cód. de Seg.: 123
Data Exp.:12/2026		VISAAutorização negada.
Retorna status DECLINED.
Número: 5240082975622454
Cód. de Seg.: 123
Data Exp.:12/2026		MASTERCARDAutorização bem-sucedida.
Retorna status AUTHORIZED ou PAID.
Número: 5530062640663264
Cód. de Seg.: 123
Data Exp.:12/2026		MASTERCARDAutorização negada.
Retorna status DECLINED.
Número: 345817690311361
Cód. de Seg.: 1234
Data Exp.:12/2026		AMERICAN EXPRESSAutorização bem-sucedida.
Retorna status AUTHORIZED ou PAID.
Número: 372938001199778
Cód. de Seg.: 1234
Data Exp.:12/2026		AMERICAN EXPRESSAutorização negada.
Retorna status DECLINED.
Número: 4514161122113757
Cód. de Seg.: 123
Data Exp.:12/2026		ELOAutorização bem-sucedida.
Retorna status AUTHORIZED ou PAID.
Número: 4389350446134811
Cód. de Seg.: 123
Data Exp.:12/2026		ELOAutorização negada.
Retorna status DECLINED.
Número: 6062828598919021
Cód. de Seg.: 123
Data Exp.:12/2026		HIPERAutorização bem-sucedida.
Retorna status AUTHORIZED ou PAID.
Número: 6062822916014409
Cód. de Seg.: 123
Data Exp.:12/2026		HIPERAutorizaçã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"
    }
  ]
}