Create a Pagar.me card

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

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

Request body

customerId

Required. Pagar.me customer ID owned by the authenticated AtomicPay account.

token

Required by the payment backend. Token generated by the card/tokenization flow.

POST/v1/cards/pagarme

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

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

Request examples

curl

curl -X POST "https://api.atomicpay.com.br/v1/cards/pagarme" \
  -H "Authorization: Bearer {{api_key}}" \
  -H "Content-Type: application/json" \
  -d '{
  customerId: 'cus_pagarme_123',
  token: 'token_from_pagarme_js'
}'

request.js

const response = await fetch('https://api.atomicpay.com.br/v1/cards/pagarme', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer {{api_key}}',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  customerId: 'cus_pagarme_123',
  token: 'token_from_pagarme_js'
}),
});

const data = await response.json();

Response

response.json

{
  "id": "card_123",
  "first_six_digits": "411111",
  "last_four_digits": "1111",
  "brand": "Visa",
  "holder_name": "Jenny Rosen",
  "customer": { "id": "cus_pagarme_123" }
}

Retrieve a Pagar.me customer

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

List Pagar.me cards

List saved Pagar.me cards for a verified customer.