payabli/integration-skills

payabli-subscriptions

Use when building recurring billing on Payabli — subscriptions, autopay, scheduled charges, retry/dunning logic, or moving one-time charges to recurring.

Voir la source

Mode d’emploi

  1. Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
  2. Consultez le document original pour les outils, identifiants et environnements requis.
  3. Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/payabli/integration-skills --skill payabli-subscriptions

Avant de commencer

  • L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
  • Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

Payabli subscriptions (recurring billing)

Set up and manage recurring charges (autopays).

Load fundamentals first

If payabli-fundamentals is not already loaded, load it now, then continue.

On load

If payabli-integration.md exists at the repo root, read it; honor its ## SDK value.

Create and manage a subscription

POST /Subscription/add creates an autopay; update and delete with PUT/DELETE /Subscription/{subId}. A subscription always links to a customer (pass customerId), and Payabli tokenizes the method automatically. Scheduled autopays run roughly 2:30–3:30 AM ET; to test the run end to end, use valid schedule data (a bad schedule is rejected) and schedule a near-term time, then wait — no Payabli-side trigger is needed. https://docs.payabli.com/guides/pay-in-developer-subscriptions-manage.md

Schedule: in scheduleDetails, set frequency and an endDate. frequency is one of onetime, weekly, every2weeks, monthly, every3months, every6months, annually, or the month-anchored firstofmonth / fifteenthofmonth / endofmonth. For an open-ended autopay — the common case — set endDate: "untilcancelled"; omitting endDate fails with Invalid Schedule data.

Read and list: read one with GET /Subscription/{subId}; list with the Query API (GET /Query/subscriptions/{entry}). A customer's subscriptions are also embedded in GET /Customer/{customerId} as Subscriptions[]. Render state from the integer SubStatus — see the subscription status reference.

To put a digital wallet (Apple Pay, Google Pay) on a subscription, tokenize it through the ExpressCheckout UI first — wallets are tokenized via ExpressCheckout, not the standard stored-method flow. https://docs.payabli.com/guides/pay-in-components-express-checkout.md

Set CIT/MIT indicators

Recurring charges are merchant-initiated. Send the initiator field (payor = cardholder-initiated, merchant = merchant-initiated) and storedMethodUsageType (for example subscription). Wrong indicators cause declines, fee miscalculation, and chargeback-liability shifts; if omitted, Payabli defaults to merchant + unscheduled, which may not match intent. https://docs.payabli.com/guides/pay-in-transactions-cit-mit-overview.md

Handle failures — Payabli does not auto-retry

Payabli does not retry a failed autopay. Implement retry/dunning yourself: listen for the DeclinedPayment webhook, find the subscription via the transaction's schedule reference, then update the method and retry or notify the customer. Pause with PUT /Subscription/{subId} (setPause: true); skip a cycle with totalAmount: 0. https://docs.payabli.com/guides/pay-in-developer-subscriptions-utilities.md

Most autopay declines are expired cards — keeping stored cards current with the Card Account Updater (a paid add-on; see payabli-tokenization) heads off many of them.

Boundaries

  • One-time charges and the payment surfaces → payabli-accept-payments
  • Saving the payment method → payabli-tokenization
  • Receiving the DeclinedPayment event → payabli-webhooks
du même dépôt

Autres Skills

Tous les Skills
payabli
Communauté

payabli-accept-payments

Use when writing code that accepts payments through Payabli: charging cards or ACH, integrating embedded payment components or a hosted payment page, handling Apple Pay or Google Pay, or processing voids and refunds. Boundaries — subscriptions: payabli-subscriptions; invoices and payment links: payabli-invoices; disputes and refund-failure recovery: payabli-disputes. Reads payabli-integration.md on load if present.

Installations / 1h
1
GitHub Stars
0
Mis à jour
23 oct.
payabli
Communauté

payabli-bills

Use when building accounts-payable automation on Payabli — capturing vendor bills (manual entry or OCR) and paying them through Pay Out. Distinct from raw payouts (payabli-send-payments): a bill is a captured vendor invoice that you then pay. Reads payabli-integration.md on load if present.

Installations / 1h
1
GitHub Stars
0
Mis à jour
23 oct.
payabli
Communauté

payabli-boarding

Use when onboarding merchants to Payabli through the API — creating the business, its people, paypoints, and bank accounts, opening a boarding application, validating and submitting it, answering underwriting requests, or tracking an application's status and enablement. Moving an existing integration off the legacy /Boarding/ endpoints lives in payabli-boarding-migration. Reads payabli-integration.md on load if present.

Installations / 1h
1
GitHub Stars
0
Mis à jour
23 oct.
payabli
Communauté

payabli-boarding-migration

Use when moving an existing integration off Payabli's legacy boarding endpoints (/Boarding/app, /Boarding/read, boarding links) to intelligent boarding — converting legacy application payloads to the new records, mapping fields, values, and statuses, or planning the cutover before the legacy sunset. Building boarding from scratch lives in payabli-boarding. Reads payabli-integration.md on load if present.

Installations / 1h
1
GitHub Stars
0
Mis à jour
23 oct.