Cobrança com cartão de crédito

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' \
--header 'x-idempotency-key;' \
--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.