Autenticação

Chave de API (Basic Auth)

A API Worldfy utiliza HTTP Basic Authentication com suas chaves de API. Ao criar uma chave, você recebe um par:

• Public Key: identificador público da chave
• Secret Key: segredo da chave (exibido apenas uma vez na criação)

Para autenticar, envie o header Authorization com o valor Basic seguido da codificação Base64 de publicKey:secretKey:

curl -X GET https://api.worldfypayments.com/v1/charges \
  -H "Authorization: Basic $(echo -n 'pk_live_abc123:sk_live_xyz789' | base64)"

Construindo o Header

Exemplos por linguagem

curl -X GET https://api.worldfypayments.com/v1/charges \
  -u "pk_live_abc123:sk_live_xyz789"

const credentials = Buffer.from('pk_live_abc123:sk_live_xyz789').toString('base64');

const response = await fetch('https://api.worldfypayments.com/v1/charges', {
  headers: {
    'Authorization': `Basic ${credentials}`,
  },
});

import base64
import requests

credentials = base64.b64encode(b'pk_live_abc123:sk_live_xyz789').decode()

response = requests.get(
    'https://api.worldfypayments.com/v1/charges',
    headers={'Authorization': f'Basic {credentials}'},
)

Whitelist de IP

Ao criar ou atualizar uma chave de API, você pode configurar uma whitelist de IPs. Quando configurada, apenas requisições originadas dos IPs permitidos serão aceitas. Requisições de IPs fora da whitelist recebem 401 UNAUTHORIZED.

{
  "name": "Produção",
  "ip_whitelist": ["203.0.113.10", "203.0.113.11"]
}

Segurança