ATENÇÃO
É necessário ser PCI para gerar transações com o cartão aberto. Durante o processo de homologação será exigido o certificado.
Informando os dados essenciais para efetivação de um pagamento, este recurso permite a criação de um pedido com cobrança de pagamento com cartão de crédito ou débito.
Métodos de pagamento disponíveis:
- Cartão de Crédito (
payment_method.type = CREDIT_CARD) - Cartão de Débito (
payment_method.type = DEBIT_CARD)
O valor mínimo por transação e parcela é definido de acordo com forma de pagamento e bandeira, no caso do cartão.
| Forma de Pagamento | Bandeira | Valor Mínimo (R$) | Valor Mínimo Parcela (R$) |
|---|---|---|---|
| Cartão de Crédito | Visa | 1,00 | 5,00 |
| Cartão de Crédito | Mastercard | 0,20 | 5,00 |
| Cartão de Crédito | American Express | 0,20 | 5,00 |
| Cartão de Crédito | Demais bandeiras | 0,20 | 5,00 |
curl --location --request POST 'https://sandbox.api.pagseguro.com/orders' \
--header 'Authorization: Bearer {{TOKEN}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"reference_id": "ex-00001",
"customer": {
"name": "Jose da Silva",
"email": "[email protected]",
"tax_id": "12345678909",
"phones": [
{
"country": "55",
"area": "11",
"number": "999999999",
"type": "MOBILE"
}
]
},
"items": [
{
"reference_id": "referencia do item",
"name": "nome do item",
"quantity": 1,
"unit_amount": 500
}
],
"shipping": {
"address": {
"street": "Avenida Brigadeiro Faria Lima",
"number": "1384",
"complement": "apto 12",
"locality": "Pinheiros",
"city": "São Paulo",
"region_code": "SP",
"country": "BRA",
"postal_code": "01452002"
}
},
"notification_urls": [
"https://meusite.com/notificacoes"
],
"charges": [
{
"reference_id": "referencia da cobranca",
"description": "descricao da cobranca",
"amount": {
"value": 500,
"currency": "BRL"
},
"payment_method": {
"type": "CREDIT_CARD",
"installments": 1,
"capture": true,
"card": {
"number": "4111111111111111",
"exp_month": "12",
"exp_year": "2026",
"security_code": "123",
"holder": {
"name": "Jose da Silva"
},
"store": false
}
}
}
]
}'
{
"id": "ORDE_1B946E10-A183-4F80-BA82-E4D10BA75574",
"reference_id": "ex-00001",
"created_at": "2023-02-08T15:01:09.068-03:00",
"customer": {
"name": "Jose da Silva",
"email": "[email protected]",
"tax_id": "12345678909",
"phones": [
{
"type": "MOBILE",
"country": "55",
"area": "11",
"number": "999999999"
}
]
},
"items": [
{
"reference_id": "referencia do item",
"name": "nome do item",
"quantity": 1,
"unit_amount": 500
}
],
"shipping": {
"address": {
"street": "Avenida Brigadeiro Faria Lima",
"number": "1384",
"complement": "apto 12",
"locality": "Pinheiros",
"city": "São Paulo",
"region_code": "SP",
"country": "BRA",
"postal_code": "01452002"
}
},
"charges": [
{
"id": "CHAR_89EFFBA8-69F5-42FC-88F9-2E9BAA26A4F3",
"reference_id": "referencia da cobranca",
"status": "PAID",
"created_at": "2023-02-08T15:01:09.313-03:00",
"paid_at": "2023-02-08T15:01:10.000-03:00",
"description": "descricao da cobranca",
"amount": {
"value": 500,
"currency": "BRL",
"summary": {
"total": 500,
"paid": 500,
"refunded": 0
}
},
"payment_response": {
"code": "20000",
"message": "SUCESSO",
"reference": "032416400102"
},
"payment_method": {
"type": "CREDIT_CARD",
"installments": 1,
"capture": true,
"card": {
"brand": "visa",
"first_digits": "411111",
"last_digits": "1111",
"exp_month": "12",
"exp_year": "2026",
"holder": {
"name": "Jose da Silva"
},
"store": false
},
"soft_descriptor": "IntegracaoPagsegu"
},
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_89EFFBA8-69F5-42FC-88F9-2E9BAA26A4F3",
"media": "application/json",
"type": "GET"
},
{
"rel": "CHARGE.CANCEL",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_89EFFBA8-69F5-42FC-88F9-2E9BAA26A4F3/cancel",
"media": "application/json",
"type": "POST"
}
]
}
],
"notification_urls": [
"https://meusite.com/notificacoes"
],
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_1B946E10-A183-4F80-BA82-E4D10BA75574",
"media": "application/json",
"type": "GET"
},
{
"rel": "PAY",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_1B946E10-A183-4F80-BA82-E4D10BA75574/pay",
"media": "application/json",
"type": "POST"
}
]
}
Recomendações
Com o intuito de melhorarmos a experiência de nossos parceiros e visando sempre uma integração saudável e segura,
orientamos fortemente que em sua tela de checkout seja implementado recursos adicionais de segurança, assim como a utilização de um reCaptcha, evitando assim que seu site fique sujeito a ataques de robôs para validação de cartões e outros tipos de fraudes que podem impactar negativamente em suas vendas e negócio.