Skip to main content
Ao final deste guia você terá uma API key válida e uma resposta autenticada da API da iuzypay.

​
Pré-requisitos

  • Uma conta na iuzypay — crie a sua gratuitamente.
  • Um terminal com curl (ou o cliente HTTP da sua preferência).

​
Primeira chamada

1

Crie uma API key

No dashboard, acesse Configurações → API keys e clique em Criar API key. Dê um nome que identifique o uso (por exemplo, servidor-producao).
A chave completa (iuzy_sk_...) é exibida uma única vez, na criação. Guarde-a em um gerenciador de segredos — depois disso a iuzypay armazena apenas um hash e não consegue recuperá-la.
2

Guarde a chave como variável de ambiente

Nunca coloque a chave no código. Exporte-a no ambiente do seu servidor:
export IUZYPAY_API_KEY="iuzy_sk_..."
3

Chame a API

O endpoint GET /v1/me valida a chave e retorna a organização dona dela:
curl https://api.iuzypay.com/v1/me \
  -H "Authorization: Bearer $IUZYPAY_API_KEY"
Resposta esperada:
{
  "organization": {
    "id": "6f1c9d2e-8a4b-4c3d-9e2f-1a2b3c4d5e6f",
    "name": "Minha Empresa"
  },
  "api_key": {
    "id": "0b7e4a1c-2d3e-4f5a-8b9c-0d1e2f3a4b5c",
    "prefix": "iuzy_sk_AbCd"
  }
}

​
Próximos passos

Convenções da API

Entenda erros, IDs, valores em centavos e paginação antes de integrar.

Receber webhooks

Cadastre um endpoint e receba eventos assinados da sua conta.