Retrieve a Pagar.me customer

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

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

Path parameters

customerId

Required. Pagar.me customer ID. AtomicPay checks ownership before proxying the request.

GET/v1/customers/pagarme/:customerId

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

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

Request examples

curl

curl "https://api.atomicpay.com.br/v1/customers/pagarme/cus_pagarme_123" \
  -H "Authorization: Bearer {{api_key}}"

request.js

const response = await fetch('https://api.atomicpay.com.br/v1/customers/pagarme/cus_pagarme_123', {
  method: 'GET',
  headers: { Authorization: 'Bearer {{api_key}}' },
});

const data = await response.json();

Response

response.json

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

Create a Pagar.me customer

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

Create a Pagar.me card

Create a saved card for an existing Pagar.me customer.