Informando os dados essenciais para efetivação de uma cobrança, este recurso permite a criação de uma 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/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,
"soft_descriptor": "My Store",
"card": {
"number": "4111111111111111",
"exp_month": "03",
"exp_year": "2026",
"security_code": "123",
"holder": {
"name": "Jose da Silva"
}
}
},
"notification_urls": [
"https://yourserver.com/nas_ecommerce/277be731-3b7c-4dac-8c4e-4c3f4a1fdc46/"
]
}'
{
"id": "CHAR_D32A01A9-92A6-4755-B21D-7B6A1291F7AD",
"reference_id": "ex-00001",
"status": "AUTHORIZED",
"created_at": "2019-04-17T20:07:07.002-02",
"paid_at": "2019-04-17T20:07:07.002-02",
"description": "Motivo do pagamento",
"amount": {
"value": 1000,
"currency": "BRL",
"summary": {
"total": 1000,
"paid": 0,
"refunded": 0
}
},
"payment_response": {
"code": 20000,
"message": "SUCESSO",
"reference": "071200027526"
},
"payment_method": {
"type": "CREDIT_CARD",
"installments": 1,
"capture": false,
"soft_descriptor": "My Store",
"card": {
"brand": "VISA",
"first_digits": "411111",
"last_digits": "1111",
"exp_month": "03",
"exp_year": "2026",
"holder": {
"name": "Jose da Silva"
}
}
},
"notification_urls": [
"https://yourserver.com/nas_erp/277be731-3b7c-4dac-8c4e-4c3f4a1fdc46/"
],
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_D32A01A9-92A6-4755-B21D-7B6A1291F7AD",
"media": "application/json",
"type": "GET"
},
{
"rel": "CHARGE.CANCEL",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_D32A01A9-92A6-4755-B21D-7B6A1291F7AD/cancel",
"media": "application/json",
"type": "POST"
},
{
"rel": "CHARGE.CAPTURE",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_D32A01A9-92A6-4755-B21D-7B6A1291F7AD/capture",
"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.