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ão | Bandeira | Comportamento |
---|---|---|
Número: 4539620659922097 Cód. Seg.:123 Data Exp.:12/2026 | VISA | Autorização bem sucedida Retorna status AUTHORIZED ou PAID |
Número: 4929291898380766 Cód. Seg.:123 Data Exp.:12/2026 | VISA | Autorização negada Retorna status DECLINED |
Número: 5240082975622454 Cód. Seg.:123 Data Exp.:12/2026 | MASTERCARD | Autorização bem sucedida Retorna status AUTHORIZED ou PAID |
Número: 5530062640663264 Cód. Seg.:123 Data Exp.:12/2026 | MASTERCARD | Autorização negada Retorna status DECLINED |
Número: 345817690311361 Cód. Seg.:1234 Data Exp.:12/2026 | AMERICAN EXPRESS | Autorização bem sucedida Retorna status AUTHORIZED ou PAID |
Número: 372938001199778 Cód. Seg.:1234 Data Exp.:12/2026 | AMERICAN EXPRESS | Autorização negada Retorna status DECLINED |
Número: 4514161122113757 Cód. Seg.:123 Data Exp.:12/2026 | ELO | Autorização bem sucedida Retorna status AUTHORIZED ou PAID |
Número: 4389350446134811 Cód. Seg.:123 Data Exp.:12/2026 | ELO | Autorização negada Retorna status DECLINED |
Número: 6062828598919021 Cód. Seg.:123 Data Exp.:12/2026 | HIPER | Autorização bem sucedida Retorna status AUTHORIZED ou PAID |
Número: 6062822916014409 Cód. Seg.:123 Data Exp.:12/2026 | HIPER | Autorizaçã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"
}
]
}