Create a custom charge

Create a one-off PIX or credit card charge through the AtomicPay public payment API.

Last updated

Author: AtomicPay API

Authentication

Send your AtomicPay developer API key using Authorization: Bearer <API_KEY> or X-API-Key: <API_KEY>. This endpoint requires charges.write permission, unless the key has wildcard access (*).

Request body

customerId

Required. Pagar.me customer ID owned by the authenticated AtomicPay account. The aliases customer_id, customer.id, and customer.pagarme_customer_id are also accepted.

paymentMethod

Required by the payment backend. Common values are pix and credit_card.

amount

Required by the payment backend. Amount in BRL cents, for example 1000 for R$ 10,00.

POST/v1/charges/custom

Base URL: https://api.atomicpay.com.br

Create a one-off PIX or credit card charge through the AtomicPay public payment API.

Request examples

curl

curl -X POST "https://api.atomicpay.com.br/v1/charges/custom" \
  -H "Authorization: Bearer {{api_key}}" \
  -H "Content-Type: application/json" \
  -d '{
  amount: 1000,
  paymentMethod: 'pix',
  customerId: 'cus_pagarme_123',
  description: 'Order #1001'
}'

request.js

const response = await fetch('https://api.atomicpay.com.br/v1/charges/custom', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer {{api_key}}',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  amount: 1000,
  paymentMethod: 'pix',
  customerId: 'cus_pagarme_123',
  description: 'Order #1001'
}),
});

const data = await response.json();

Response

response.json

{
  "id": "or_123",
  "object": "order",
  "status": "pending",
  "charges": [
    {
      "id": "ch_123",
      "status": "pending",
      "payment_method": "pix",
      "last_transaction": {
        "qr_code": "000201...",
        "qr_code_url": "https://..."
      }
    }
  ]
}

Cancel a subscription

Cancel an active subscription and store the cancellation reason.

Create a Pagar.me customer

Create a Pagar.me customer through AtomicPay and attach AtomicPay tenant metadata automatically.