Create a Pagar.me customer

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

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 customers.write permission, unless the key has wildcard access (*).

Request body

name

Required. Customer full name or business name. Maximum 255 characters.

email

Required. Customer email. Maximum 320 characters.

Other fields

Additional JSON fields are forwarded to the payment backend and Pagar.me. AtomicPay automatically adds tenant metadata.

POST/v1/customers/pagarme

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

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

Request examples

curl

curl -X POST "https://api.atomicpay.com.br/v1/customers/pagarme" \
  -H "Authorization: Bearer {{api_key}}" \
  -H "Content-Type: application/json" \
  -d '{
  name: 'Jenny Rosen',
  email: 'jenny@example.com',
  document: '12345678900',
  type: 'individual'
}'

request.js

const response = await fetch('https://api.atomicpay.com.br/v1/customers/pagarme', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer {{api_key}}',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  name: 'Jenny Rosen',
  email: 'jenny@example.com',
  document: '12345678900',
  type: 'individual'
}),
});

const data = await response.json();

Response

response.json

{
  "id": "cus_pagarme_123",
  "name": "Jenny Rosen",
  "email": "jenny@example.com",
  "document": "12345678900",
  "type": "individual",
  "metadata": {
    "atomicpay_company_id": "company_123",
    "atomicpay_api_key_id": "key_123"
  }
}

Create a custom charge

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

Retrieve a Pagar.me customer

Retrieve a Pagar.me customer after AtomicPay verifies it belongs to the authenticated account.