Começo rápido

Neste guia você cria um link de pagamento de 250 XRP no ambiente de teste e acompanha até ele ser pago.

1. 1

   Crie a conta e verifique a empresa

   No painel, cadastre a empresa e conecte a carteira de recebimento (Xaman, MetaMask, Crossmark ou GemWallet). Em produção, a empresa precisa ter a verificação (KYB) aprovada.

2. 2

   Gere uma chave de API

   Em Integração › Chaves de API, crie uma chave. No modo de teste ela começa com ak_mer_. Ela aparece uma única vez: guarde num cofre de segredos.

   cURL

   Copiar

   curl https://api.pineplechain.com/v1/me \
     -H "x-api-key: ak_mer_••••••••••••••••"

3. 3

   Crie o link de pagamento

   Envie o valor como texto. O idempotency-key garante que, se a chamada for repetida, só um link é criado.

   cURLNode.js

   Copiar

   curl -X POST https://api.pineplechain.com/v1/invoices \
     -H "x-api-key: $PINEPLECHAIN_API_KEY" \
     -H "content-type: application/json" \
     -H "idempotency-key: pedido-1842" \
     -d '{ "amount": "250", "description": "Pedido #1842", "expires_in_hours": 48 }'

4. 4

   Mande o link e acompanhe

   Envie o url para quem vai pagar. Depois, consulte a cobrança até o status virar paid.

   cURL

   Copiar

   curl https://api.pineplechain.com/v1/invoices/inv_8f2kQm4xL0aB7cD9eF1g \
     -H "x-api-key: $PINEPLECHAIN_API_KEY"

{
  "id": "inv_8f2kQm4xL0aB7cD9eF1g",
  "object": "invoice",
  "kind": "direct",
  "status": "open",
  "amount": { "value": "250", "asset": { "type": "XRP" } },
  "description": "Pedido #1842",
  "receive_address": "rPq8vN3hT7xKdY2mWzQ5bR9sLc4fJ7XkM",
  "url": "https://app.pineplechain.com/pay/l3Xk9QmT2pRw",
  "expires_at": "2026-11-01T14:00:00.000Z",
  "escrow": null,
  "paid": null,
  "metadata": {},
  "created_at": "2026-10-30T14:00:00.000Z"
}