Criar um Cliente

Crie um registro de cliente para armazenar identidade de cobranca, metadata e contexto para futuros pagamentos.

Ultima atualizacao

Autor: Marco Silva

Autenticacao

Envie sua chave secreta do AtomicPay no header Authorization. Nunca exponha chaves secretas no codigo do cliente.

Parametros

name

Nome completo ou nome comercial do cliente. Recomendado para melhorar suporte e identificacao interna.

email

Email do cliente usado para recibos, buscas de conta e acompanhamento operacional.

metadata

Pares chave-valor para ids internos como CRM, regiao comercial ou segmento do lojista.

POST/v1/customers

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

Cria um cliente e retorna o objeto completo quando a requisicao e valida.

Exemplos de requisicao

curl

curl https://api.atomicpay.com.br/v1/customers \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jenny Rosen",
    "email": "jennyrosen@example.com",
    "metadata": {
      "crm_id": "crm_2048",
      "region": "br"
    }
  }'

customers.js

const response = await fetch('https://api.atomicpay.com.br/v1/customers', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + process.env.ATOMICPAY_SECRET_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Jenny Rosen',
    email: 'jennyrosen@example.com',
    metadata: {
      crm_id: 'crm_2048',
      region: 'br',
    },
  }),
});

const customer = await response.json();

Response

response.json

{
  "id": "cus_Q8m1K2r4N6",
  "object": "customer",
  "name": "Jenny Rosen",
  "email": "jennyrosen@example.com",
  "metadata": {
    "crm_id": "crm_2048",
    "region": "br"
  },
  "created_at": "2026-04-06T11:45:00Z"
}

Documentos relacionados

Mantenha o ritmo

Documentacao

Inicio Rapido

Crie seu workspace, conecte um provedor e publique seu primeiro fluxo de pagamento.

April 3, 2026

Documentacao

Conectar um Provedor de Pagamento

Mapeie credenciais, callbacks e segredos de assinatura com seguranca.

April 3, 2026