n1coePayDocs

Empezar

Obtén tus llaves

Configura tu tienda en n1co ePay y guarda tus tres llaves.

≈ 3 minutos · curl

Antes de empezar

  • Una tienda n1co.
  • Una aplicación del API de Integración de n1co con los permisos «Administrador de tienda» y «Pasarela de pagos».
  • Tu servidor: Node.js, .NET, PHP, Java o curl.

Paso 1Configura tu tienda

Configura tu tienda con el client id y el client secret de tu aplicación. Es el único llamado sin secret_key.

curl

POST /v1/setup
# La primera configuración puede tardar cerca de un minuto.
curl -s -X POST https://api-epay-sandbox.n1co.shophttps://api-epay.n1co.com/v1/setup \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": "<client id de tu aplicación>",
    "client_secret": "<client secret de tu aplicación>",
    "webhook_url": "https://hooks.example.com/n1co"
  }'
201Created
{
  "store_id": "0b9f8a52-2f0e-4d84-9a52-6c1f7e0d9a11",
  "store_name": "Example Store",
  "publishable_key": "pk_3x4mpl3pUbl1shabl3k3yAAAAAAAAAAA",
  "secret_key": "sk_3x4mpl3s3cr3tk3yAAAAAAAAAAAAAAAA",
  "webhook": {
    "url": "https://hooks.example.com/n1co",
    "secret": "whsec_MfKQ9r8GKYqrTwjUPD8ILPZIo2LaLaSw"
  }
}
  • Tu páginapublishable_keypk_ y 32 caracteres
  • Tu servidorsecret_keysk_ y 32 caracteres
  • Tu servidorwebhook.secretwhsec_ y 32 caracteres

Paso 2Rota tus llaves

Repite POST /v1/setup con el mismo client_id y client_secret. El valor rotado reemplaza al anterior en cuanto llega la respuesta: despliégalo de inmediato. publishable_key no se rota.

POST /v1/setup
# Para rotar webhook.secret, envía "rotate_webhook_secret": true.
curl -s -X POST https://api-epay-sandbox.n1co.shophttps://api-epay.n1co.com/v1/setup \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": "<client id de tu aplicación>",
    "client_secret": "<client secret de tu aplicación>",
    "webhook_url": "https://hooks.example.com/n1co",
    "rotate_secret_key": true
  }'
200OK
{
  "store_id": "0b9f8a52-2f0e-4d84-9a52-6c1f7e0d9a11",
  "store_name": "Example Store",
  "publishable_key": "pk_3x4mpl3pUbl1shabl3k3yAAAAAAAAAAA",
  "secret_key": "sk_3x4mpl3s3cr3tk3yAAAAAAAAAAAAAAAA",
  "webhook": { "url": "https://hooks.example.com/n1co" }
}
Envías Recibes
"rotate_secret_key": true 200 con un secret_key nuevo
"rotate_webhook_secret": true 200 con un webhook.secret nuevo
Otra webhook_url 200 con un webhook.secret nuevo
La misma configuración 409 store_already_enabled, sin secretos

Tu tienda está lista.

Con tus llaves, sigue con tus webhooks.

Escribe para buscar en la documentación.