curl https://bananafy.app/api/v1/me \
 -H"Authorization: Bearer bn_live_seu_token"

{
"error": {
"code":"validation_error",
"message":"One or more fields are invalid",
"details": {"amount_cents": ["amount_cents min R$5,00 (500 cents)"] }
 }
}

HTTP/1.1 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1783493400
Content-Type: application/json

HTTP/1.1 429 Too Many Requests
Retry-After: 34
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1783493434
Content-Type: application/json

{
"error": {
"code":"rate_limited",
"message":"Rate limit exceeded for this API key."
 }
}

curl -X POST https://bananafy.app/api/v1/transactions \
 -H"Authorization: Bearer bn_live_seu_token" \
 -H"Content-Type: application/json" \
 -d '{
"amount_cents": 1990,
"method":"pix",
"product_id":"prd_SEU_ID_AQUI",
"customer": {
"email":"joao@example.com",
"name":"João Silva",
"cpf":"11144477735"
 },
"description":"Mensalidade Plano Pro",
"external_reference":"order_42",
"utm": {
"source":"fb",
"medium":"video",
"campaign":"camp-black-friday",
"content":"criativo-A",
"term":"feed",
"fbclid":"IwAR123...",
"ttclid":"",
"gclid":""
 }
 }'

{
"id":"tx_clxabc123",
"object":"transaction",
"status":"PENDING",
"method":"PIX",
"amount_cents": 1990,
"fee_cents": 449,
"net_cents": 1541,
"currency":"BRL",
"pix": {
"copy_paste":"00020126580014BR.GOV.BCB.PIX...",
"expires_at":"2026-06-01T16:30:00.000Z"
 },
"split": null,
"created_at":"2026-06-01T15:30:00.000Z"
}

curl -X POST https://bananafy.app/api/v1/transactions \
 -H"Authorization: Bearer bn_live_seu_token" \
 -H"Content-Type: application/json" \
 -d '{
"amount_cents": 5000,
"method":"pix",
"customer": {"email":"cliente@example.com" },
"description":"Acesso VIP",
"split": {
"recipient":"parceiro@example.com",
"percent": 30
 }
 }'

curl -X POST https://bananafy.app/api/v1/transactions \
 -H"Authorization: Bearer bn_live_seu_token" \
 -H"Content-Type: application/json" \
 -d '{
"amount_cents": 9990,
"method":"card",
"customer": {
"email":"maria@example.com",
"name":"Maria Souza",
"cpf":"52998224725"
 },
"description":"Curso Premium"
 }'

{
"id":"tx_clxdef456",
"object":"transaction",
"status":"PENDING",
"method":"CARD",
"amount_cents": 9990,
"fee_cents": 1349,
"net_cents": 8641,
"currency":"BRL",
"card": {
"hosted_url":"https://bananafy.app/api/v1/transactions/tx_clxdef456/card-redirect",
"message":"Redirect customer to hosted_url to enter card details (Stripe Elements, PCI-compliant)."
 },
"created_at":"2026-06-01T15:30:00.000Z"
}

curl https://bananafy.app/api/v1/transactions?status=PAID&limit=50 \
 -H"Authorization: Bearer bn_live_seu_token"

{
"data": [
 {
"id":"tx_clxabc123",
"object":"transaction",
"product_id":"prd_xxx",
"checkout_id":"ck_xxx",
"customer": {"email":"...","name":"...","cpf":"...","phone":"..." },
"amount_cents": 1990,
"fee_cents": 449,
"net_cents": 1541,
"currency":"BRL",
"method":"PIX",
"status":"PAID",
"provider":"safepix",
"provider_id":"tx_safepix_xxx",
"pix": {"qr_code":"...","copy_paste":"...","expires_at":"..." },
"card": null,
"tracking": {"utm_source":"...","utm_medium":"...","fbclid":"..." },
"split": {"recipient":"parceiro@example.com","amount_cents": 450 },
"paid_at":"2026-06-01T15:32:00.000Z",
"created_at":"2026-06-01T15:30:00.000Z",
"updated_at":"2026-06-01T15:32:00.000Z"
 }
 ],
"has_more": true,
"next_cursor":"tx_clxabc123"
}

curl https://bananafy.app/api/v1/me -H"Authorization: Bearer bn_live_seu_token"

{
"id":"usr_xxx",
"email":"voce@example.com",
"name":"Você",
"balance_cents": 12345,
"api_card_enabled": false
}

curl https://bananafy.app/api/v1/balance -H"Authorization: Bearer bn_live_seu_token"

{
"object":"balance",
"currency":"BRL",
"available_cents": 50000, // SACÁVEL agora (já liberado)
"pending_pix_cents": 12000, // PIX pago, ainda em holding
"pending_card_cents": 0, // Cartão pago, ainda em holding (D+X)
"retained_card_cents": 0, // Retenção de cartão (libera no fim do período)
"in_withdrawal_cents": 0, // Saques abertos já debitados
"upcoming_releases": [
 {"transaction_id":"tx_xxx","date":"2026-06-02T10:00:00.000Z","cents": 12000,"kind":"pix_release","method":"PIX" }
 ]
}

curl -X POST https://bananafy.app/api/v1/withdrawals \
 -H"Authorization: Bearer bn_live_seu_token" \
 -H"Content-Type: application/json" \
 -d '{
"amount_cents": 5000,
"method":"pix",
"pix_key":"voce@example.com",
"pix_key_type":"email"
 }'

{
"id":"wd_clxabc123",
"object":"withdrawal",
"status":"PENDING",
"method":"pix",
"amount_cents": 5000,
"fee_cents": 990,
"net_cents": 4010,
"pix_key":"voce@example.com",
"pix_key_type":"email",
"wallet_address": null,
"fail_reason": null,
"provider_id": null,
"paid_at": null,
"created_at":"2026-06-01T15:30:00.000Z",
"updated_at":"2026-06-01T15:30:00.000Z"
}

curl"https://bananafy.app/api/v1/withdrawals?status=PAID&limit=50" \
 -H"Authorization: Bearer bn_live_seu_token"

curl -X POST https://bananafy.app/api/v1/products \
 -H"Authorization: Bearer bn_live_seu_token" \
 -H"Content-Type: application/json" \
 -d '{
"name":"Plano Pro Mensal",
"price_cents": 1990,
"description":"Acesso completo por 30 dias",
"type":"SUBSCRIPTION",
"interval_days": 30
 }'

npm install @bananafy/node

import { Bananafy, verifyWebhook } from"@bananafy/node";

const bananafy = new Bananafy({ apiKey: process.env.BANANAFY_KEY! });

// Criar cobrança PIX
const tx = await bananafy.transactions.createPix({
 amount_cents: 4990,
 customer: {
 email:"cliente@exemplo.com",
 name:"Maria",
 cpf:"12345678900",
 phone:"11999999999",
 },
 product_name:"Assinatura Pro",
});
console.log(tx.pix?.copy_paste); // BR Code EMV

// Consultar saldo
const balance = await bananafy.balance.get();
console.log("Disponível:", balance.available_cents / 100,"BRL");

// Criar assinatura mensal
const sub = await bananafy.subscriptions.create({
 amount_cents: 4990,
 interval:"monthly",
 customer: { email:"cliente@exemplo.com", name:"Maria", cpf:"12345678900" },
});

// Verificar webhook (Express)
app.post("/webhook", express.raw({ type:"application/json" }), (req, res) => {
 const ok = verifyWebhook(
 req.body,
 req.headers["x-bananafy-signature"] as string,
 process.env.WEBHOOK_SECRET!,
 );
 if (!ok) return res.status(401).send("Invalid signature");
 const event = JSON.parse(req.body.toString());
 console.log(event.type, event.data);
 res.sendStatus(200);
});

pip install bananafy

import os
from bananafy import Bananafy, verify_webhook

bn = Bananafy(api_key=os.environ["BANANAFY_KEY"])

# Criar cobrança PIX
tx = bn.transactions.create_pix(
 amount_cents=4990,
 customer={"email":"cliente@exemplo.com","name":"Maria","cpf":"12345678900","phone":"11999999999"},
 product_name="Assinatura Pro",
)
print(tx["pix"]["copy_paste"])

# Assinatura mensal
sub = bn.subscriptions.create(
 amount_cents=4990,
 interval="monthly",
 customer={"email":"cliente@exemplo.com","name":"Maria","cpf":"12345678900"},
)

composer require bananafy/bananafy

<?php
use Bananafy\Bananafy;
use function Bananafy\verifyWebhook;

$bn = new Bananafy(apiKey: getenv('BANANAFY_KEY'));

// Criar cobrança PIX
$tx = $bn->transactions->createPix([
 'amount_cents' => 4990,
 'customer' => [
 'email' => 'cliente@exemplo.com',
 'name' => 'Maria',
 'cpf' => '12345678900',
 'phone' => '11999999999',
 ],
 'product_name' => 'Assinatura Pro',
]);
echo $tx['pix']['copy_paste'];

// Assinatura mensal
$sub = $bn->subscriptions->create([
 'amount_cents' => 4990,
 'interval' => 'monthly',
 'customer' => ['email' => 'cliente@exemplo.com', 'name' => 'Maria', 'cpf' => '12345678900'],
]);

go get github.com/luhandrade11/bananafy-go

package main

import (
"context"
"fmt"
"os"

"github.com/luhandrade11/bananafy-go"
)

func main() {
 bn := bananafy.New(os.Getenv("BANANAFY_KEY"))
 ctx := context.Background()

 tx, err := bn.CreatePix(ctx, bananafy.CreatePixInput{
 AmountCents: 4990,
 Customer: bananafy.Customer{
 Email:"cliente@exemplo.com",
 Name:"Maria",
 CPF:"12345678900",
 Phone:"11999999999",
 },
 ProductName:"Assinatura Pro",
 })
 if err != nil {
 panic(err)
 }
 fmt.Println("PIX copy-paste:", tx.PIX.CopyPaste)
}

gem install bananafy

require"bananafy"

bn = Bananafy::Client.new(api_key: ENV.fetch("BANANAFY_KEY"))

# Criar cobrança PIX
tx = bn.transactions.create_pix(
 amount_cents: 4990,
 customer: {
 email:"cliente@exemplo.com",
 name:"Maria",
 cpf:"12345678900",
 phone:"11999999999",
 },
 product_name:"Assinatura Pro",
)
puts tx["pix"]["copy_paste"]

# Assinatura mensal
sub = bn.subscriptions.create(
 amount_cents: 4990,
 interval:"monthly",
 customer: { email:"cliente@exemplo.com", name:"Maria", cpf:"12345678900" },
)

{
"id":"evt_<deliveryId>", // ESTÁVEL entre retentativas — dedupe por ele
"type":"transaction.paid",
"created": 1730476320, // unix timestamp (segundos)
"data": { /* objeto do evento (ver abaixo) */ }
}

{
"id":"tx_clxabc123",
"product_id":"prd_xxx",
"checkout_id": null,
"amount_cents": 1990,
"fee_cents": 449,
"net_cents": 1541,
"currency":"BRL",
"method":"PIX",
"status":"PAID",
"provider":"safepix",
"provider_id":"...",
"external_reference":"order_42",
"metadata": {"attendant_code":"A123" },
"customer": {"email":"...","name":"...","cpf":"...","phone":"..." },
"tracking": {"utm_source":"fb","utm_medium":"video","utm_campaign":"...",
"utm_content":"...","utm_term":"...","fbclid":"...",
"ttclid":"...","gclid":"..." },
"receipt_url": null,
"paid_at":"2026-06-01T15:32:00.000Z",
"created_at":"2026-06-01T15:30:00.000Z"
}

{
"id":"wd_xxx",
"object":"withdrawal",
"status":"PAID",
"method":"pix",
"amount_cents": 5000,
"fee_cents": 990,
"net_cents": 4010,
"pix_key":"voce@example.com",
"wallet_address": null,
"fail_reason": null,
"paid_at":"2026-06-01T16:00:00.000Z"
}

Bananafy-Signature: t=1730476320,v1=9f86d081884c7d659...

import crypto from"node:crypto";

// rawBody = corpo CRU (string), NÃO o objeto re-serializado.
function verifyWebhook(rawBody, headerValue, secret, toleranceSec = 300) {
 const parts = Object.fromEntries(
 headerValue.split(",").map((kv) => kv.split("="))
 ); // { t, v1 }
 const t = Number(parts.t);
 if (!t || Math.abs(Date.now() / 1000 - t) > toleranceSec) return false; // replay
 const expected = crypto
 .createHmac("sha256", secret)
 .update(`${t}.${rawBody}`)
 .digest("hex");
 return crypto.timingSafeEqual(
 Buffer.from(expected),
 Buffer.from(parts.v1)
 );
}

import hmac, hashlib, time

def verify_webhook(raw_body: bytes, header_value: str, secret: str, tol_sec=300):
 parts = dict(kv.split("=") for kv in header_value.split(","))
 t = int(parts.get("t", 0))
 if not t or abs(time.time() - t) > tol_sec:
 return False # replay attack
 expected = hmac.new(
 secret.encode(),
 f"{t}.".encode() + raw_body,
 hashlib.sha256,
 ).hexdigest()
 return hmac.compare_digest(expected, parts.get("v1",""))

<?php
function verifyWebhook(string $rawBody, string $header, string $secret, int $tolSec = 300): bool {
 parse_str(str_replace(',', '&', $header), $parts);
 $t = (int)($parts['t'] ?? 0);
 if (!$t || abs(time() - $t) > $tolSec) return false;
 $expected = hash_hmac('sha256', $t . '.' . $rawBody, $secret);
 return hash_equals($expected, $parts['v1'] ?? '');
}

// 1. Cria PIX (sem produto, funciona pra qualquer conta)
const res = await fetch("https://bananafy.app/api/v1/transactions", {
 method:"POST",
 headers: {
"Authorization": `Bearer ${process.env.BANANAFY_API_KEY}`,
"Content-Type":"application/json",
 },
 body: JSON.stringify({
 amount_cents: 1990,
 method:"pix",
 customer: {
 email:"cliente@example.com",
 name:"Cliente Exemplo",
 cpf:"11144477735",
 },
 description:"Pedido #42",
 external_reference:"order_42",
 }),
});

const tx = await res.json();
if (!res.ok) throw new Error(tx.error.message);

// 2. Mostra QR pro cliente
console.log("Copia-cola PIX:", tx.pix.copy_paste);
console.log("Expira em:", tx.pix.expires_at);

// 3. Espera webhook 'transaction.paid' chegar no seu endpoint
// OU pollie GET /transactions/{id} periodicamente
// OU melhor: configure o webhook em Dashboard → Integrações

{
"version":"1.0.0",
"scheme":"bananafy-brand-tokens/v1",
"colors": {
"banana": {
"400": {"hex":"#FFD84D","note":"Amarelo primário do logo" },
"500": {"hex":"#F5C518" }
 },
"peel": {
"700": {"hex":"#2a1810","note":"Ink — footer e texto principal" }
 },
"accent": {
"lime-400": {"hex":"#a3e635","note":"Dashboard CTA (Tailwind default)" }
 },
"aliases": {
"ink": {"hex":"#2a1810","alias_of":"peel-700" },
"cream": {"hex":"#FFFFFF","alias_of":"banana-50" }
 }
 },
"typography": {
"sans": {"family":"Geist Sans","weights": [400, 500, 600, 700, 800] },
"mono": {"family":"Geist Mono","weights": [400, 500, 600, 700] }
 },
"assets": {
"logo_symbol_svg":"https://bananafy.app/logo-bananafy.png",
"powered_by_dark_svg":"https://bananafy.app/brand/powered-by.svg",
"powered_by_light_svg":"https://bananafy.app/brand/powered-by-light.svg"
 }
}

import { useEffect, useState } from"react";

type BrandTokens = {
 colors: { banana: Record<string, { hex: string }>; peel: Record<string, { hex: string }> };
 typography: { sans: { family: string; fallback: string } };
 assets: { powered_by_dark_svg: string };
};

export function BananafyPoweredCheckout() {
 const [t, setT] = useState<BrandTokens | null>(null);

 useEffect(() => {
 fetch("https://bananafy.app/api/v1/brand/tokens.json")
 .then(r => r.json())
 .then(setT);
 }, []);

 if (!t) return null;

 return (
 <div style={{
 background: t.colors.banana["50"].hex,
 color: t.colors.peel["700"].hex,
 fontFamily: `${t.typography.sans.family}, ${t.typography.sans.fallback}`,
 }}>
 {/* seu checkout aqui */}
 <img src={t.assets.powered_by_dark_svg} alt="Powered by Bananafy" height={32} />
</div>
 );
}