skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
andrehfp/tinyplate50 installs

abacatepay

Help with AbacatePay payment integration in Next.js projects. Use when implementing PIX payments, managing subscriptions, handling webhooks, or debugging payment flows. Covers SDK usage, webhook verification, and billing management for Brazilian SaaS applications.

How do I install this agent skill?

npx skills add https://github.com/andrehfp/tinyplate --skill abacatepay
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill provides legitimate and secure integration patterns for the AbacatePay payment gateway. It correctly uses placeholders for sensitive environment variables and includes essential security practices such as HMAC signature verification for webhooks and idempotent event handling. No malicious patterns were detected.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · No issues

  • Runlayerpass

    3 files scanned · No issues

  • ZeroLeakspass

    1 finding · Score: 86/100

What does this agent skill do?

AbacatePay Integration Helper

Assist with AbacatePay payment gateway integration for Brazilian SaaS applications.

Quick Reference

Installation

bun add abacatepay-nodejs-sdk

Environment Variables

ABACATEPAY_API_KEY="abp_live_..."      # API key from dashboard
ABACATEPAY_WEBHOOK_SECRET="whsec_..."  # Webhook secret
NEXT_PUBLIC_APP_URL="https://..."      # For callback URLs

SDK Initialization

import AbacatePay from "abacatepay-nodejs-sdk";
const abacate = AbacatePay(process.env.ABACATEPAY_API_KEY!);

Common Tasks

1. Create a PIX Payment

const response = await abacate.billing.create({
  frequency: "ONE_TIME",
  methods: ["PIX"],
  products: [{
    externalId: "plan-pro",
    name: "Plano Pro",
    quantity: 1,
    price: 2990, // R$ 29,90 in centavos
  }],
  customer: {
    email: "user@example.com",
    name: "João Silva",
  },
  returnUrl: "https://app.com/pricing",
  completionUrl: "https://app.com/billing/success",
});

// response.data: { id, url, status, amount }

2. Create PIX QR Code (Direct)

const response = await abacate.pixQrCode.create({
  amount: 2990, // R$ 29,90
  expiresIn: 3600, // 1 hour
  description: "Payment description",
});

// response.data: { id, brCode, brCodeBase64, status, expiresAt }

3. Check Payment Status

const response = await abacate.pixQrCode.check({ id: "pix_abc123" });
// response.data.status: "PENDING" | "PAID" | "EXPIRED" | "CANCELLED"

4. Simulate Payment (Dev Mode)

await abacate.pixQrCode.simulatePayment({ id: "pix_abc123" });

Webhook Handling

Signature Verification (HMAC-SHA256)

import crypto from "crypto";

function validateSignature(payload: string, signature: string, secret: string): boolean {
  const expected = crypto
    .createHmac("sha256", secret)
    .update(payload)
    .digest("hex");
  return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
}

Webhook Events

EventDescription
billing.paidPayment confirmed via PIX
withdraw.doneWithdrawal completed
withdraw.failedWithdrawal failed

Webhook Payload Structure

interface WebhookPayload {
  id: string;              // Event ID (use for idempotency)
  event: string;           // Event type
  devMode: boolean;        // True if test environment
  data: {
    billing?: {
      id: string;
      amount: number;
      status: string;
    };
  };
}

Pricing

MethodFee
PIXR$ 0,80 flat per transaction
Credit Card3.5% + R$ 0,60
WithdrawalR$ 0,80 (up to 20/month)

Database Schema Overview

Plans Table

  • id: Plan identifier (e.g., "pro-monthly")
  • priceInCents: Price in centavos (R$ 29,90 = 2990)
  • interval: "monthly" | "yearly" | "lifetime"
  • limits: JSONB with feature limits
  • features: JSONB array of display features

Subscriptions Table

  • userId: One subscription per user (unique)
  • planId: Current plan
  • status: "active" | "cancelled" | "expired"
  • currentPeriodStart/End: Subscription validity

Payments Table

  • abacateBillingId: AbacatePay billing ID
  • status: "pending" | "paid" | "expired"
  • paidAt: Payment confirmation timestamp

Common Patterns

See references/integration-patterns.md for:

  • Subscription management
  • Idempotent webhook handling
  • Feature gating
  • Error handling

API Reference

See references/api-reference.md for complete endpoint documentation.

Testing Checklist

  • Environment variables configured
  • SDK connects successfully
  • Checkout creates billing and returns URL
  • Webhook receives events (use AbacatePay dashboard)
  • Payment status updates correctly
  • Subscription created after payment
  • Idempotency prevents duplicates

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/andrehfp/tinyplate/abacatepay">View abacatepay on skillZs</a>