Crear un Cliente

Crea un registro de cliente para guardar identidad de cobro, metadata y contexto para futuros pagos.

Ultima actualizacion

Autor: Marco Silva

Autenticacion

Envia tu clave secreta de AtomicPay en el header Authorization. Nunca expongas claves secretas en codigo del cliente.

Parametros

name

Nombre completo o nombre comercial del cliente. Recomendado para mejorar soporte e identificacion interna.

email

Correo del cliente para recibos, busquedas de cuenta y seguimiento operativo.

metadata

Pares clave-valor para ids internos como CRM, region comercial o segmento del comercio.

POST/v1/customers

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

Crea un cliente y devuelve el objeto completo cuando la peticion es valida.

Ejemplos de peticion

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

Mantén el impulso

Documentacion

Inicio Rapido

Crea tu espacio, conecta un proveedor y publica tu primer flujo de pago.

April 3, 2026

Documentacion

Conectar un Proveedor de Pago

Mapea credenciales, callbacks y secretos de firma de forma segura.

April 3, 2026