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

Cartões de teste

O PagSeguro Sandbox é um ambiente de teste que deve ser usado para você integrar e testar os processos de interação entre o seu sistema e o PagSeguro.

Nenhuma das transações realizadas nesse ambiente tem valor monetário e nele é possível simular diversas alterações de estado das transações e, caso necessário, reenviar notificações.
Lista de cartões de teste para que você possa simular diversos cenários diferentes em sua aplicação usando os recursos da plataforma de APIs PagSeguro.

Recurso disponível:

  • Pedidos (/orders)
  • Pagamento de pedidos (/orders/pay)

❗️

Atenção

Todos os números de cartões de créditos listado abaixo são fictícios e não devem ser utilizados em ambiente produtivo.

CartãoBandeiraComportamento
Número: 4539620659922097
Cód. Seg.:123
Data Exp.:12/2026
VISAAutorização bem sucedida
Retorna status AUTHORIZED ou PAID
Número: 4929291898380766
Cód. Seg.:123
Data Exp.:12/2026
VISAAutorização negada
Retorna status DECLINED
Número: 5240082975622454
Cód. Seg.:123
Data Exp.:12/2026
MASTERCARDAutorização bem sucedida
Retorna status AUTHORIZED ou PAID
Número: 5530062640663264
Cód. Seg.:123
Data Exp.:12/2026
MASTERCARDAutorização negada
Retorna status DECLINED
Número: 345817690311361
Cód. Seg.:1234
Data Exp.:12/2026
AMERICAN EXPRESSAutorização bem sucedida
Retorna status AUTHORIZED ou PAID
Número: 372938001199778
Cód. Seg.:1234
Data Exp.:12/2026
AMERICAN EXPRESSAutorização negada
Retorna status DECLINED
Número: 4514161122113757
Cód. Seg.:123
Data Exp.:12/2026
ELOAutorização bem sucedida
Retorna status AUTHORIZED ou PAID
Número: 4389350446134811
Cód. Seg.:123
Data Exp.:12/2026
ELOAutorização negada
Retorna status DECLINED
Número: 6062828598919021
Cód. Seg.:123
Data Exp.:12/2026
HIPERAutorização bem sucedida
Retorna status AUTHORIZED ou PAID
Número: 6062822916014409
Cód. Seg.:123
Data Exp.:12/2026
HIPERAutorização negada
Retorna status DECLINED

Exemplo

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"
    }
  ]
}