Adding Payments

post

Header parameters

AuthorizationstringRequired

Authorization: Bearer header with token is required.

Keep your API key confidential.

Body

application/json

ttlintegerRequired

Branta will remove the payment after ttl seconds.

Example: 86400

descriptionstringOptionalExample: Order #123

metadatastringOptional

Optional stringified JSON to show the user.

Example: {"Name": "S*****", "Email": "s******.com"}

Responses

201

Payment created successfully

401

Unauthorized

application/json

422

Unprocessable Content

application/json

post

/payments

HTTPcURLJavaScriptPython

POST /v2/payments HTTP/1.1
Host: staging.guardrail.branta.pro
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 245

{
  "destinations": [
    {
      "value": "lnurl1dp68gurn8ghj7c3wwdshguewvdhkvjndatxvsmtf5csdymt9v",
      "zk": false
    },
    {
      "value": "n2s5RV76sAMnQIOTMeRLsKkbS53g2v4gFUnH7i/RtRg4ZpIrDQq8WohDP9obSLLBGVrSnc8dR9TUC89veSg=",
      "zk": true
    }
  ],
  "description": "Order #123",
  "ttl": "86400"
}

No content

Zero Knowledge

Zero Knowledge requires the API caller to encrypt the destination value before POST. Below is a javascript example of the encryption algorithm.

async function encrypt(value, secret) {
  const keyData = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(secret));
  const key = await crypto.subtle.importKey('raw', keyData, { name: 'AES-GCM' }, false, ['encrypt']);

  const iv = crypto.getRandomValues(new Uint8Array(12));
  const encrypted = await crypto.subtle.encrypt(
    { name: 'AES-GCM', iv: iv },
    key,
    new TextEncoder().encode(value)
  );

  const combined = new Uint8Array(iv.length + encrypted.byteLength);
  combined.set(iv, 0);
  combined.set(new Uint8Array(encrypted), iv.length);

  return btoa(String.fromCharCode(...combined));
}

const address = '1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa';
const secret = crypto.randomUUID();

await encrypt(address, secret);
// Result:
// LQdBBewrzglmPYwUVoSjBJihA/Br8o+T1ArXGLaAuh7yJiW2dClzSBSUbUH1zhPo1WUBtr7JaFQ7wkK7CG4=