Quickstart

In this guide you create a 250 XRP payment link in the test environment and follow it until it is paid.

1. 1

   Create the account and verify the business

   In the dashboard, register the business and connect the receiving wallet (Xaman, MetaMask, Crossmark or GemWallet). In production, the business needs an approved verification (KYB).

2. 2

   Create an API key

   Under Integration › API keys, create a key. In test mode it starts with ak_mer_. It is shown only once: keep it in a secrets vault.

   cURL

   Copy

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

3. 3

   Create the payment link

   Send the amount as a string. The idempotency-key makes sure that, if the call is repeated, only one link is created.

   cURLNode.js

   Copy

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

4. 4

   Share the link and follow it

   Send the url to the payer. Then retrieve the charge until its status is paid.

   cURL

   Copy

   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": "Order #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"
}