payabli/integration-skills

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.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/payabli/integration-skills --skill payabli-accept-payments

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Payabli accept payments (Pay In)

Core Pay In: take a payment, choose the integration surface, and handle the transaction through its lifecycle.

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 for code examples and its ## Pay In scope.

Step 1 — Choose the integration approach

Three ways to collect a payment. Recommend embedded components as the default (lowest PCI scope); the others are valid when the partner needs them. Enumerate — don't decide for them.

  • Embedded components (recommended) — payment UI inside the partner's app; Payabli handles card data, keeping PCI scope low. They can be extended with the temporary token flow for full API control over the charge while still keeping card data off the server (see payabli-tokenization). https://docs.payabli.com/guides/pay-in-components-overview.md
  • Hosted payment page — no-code, Payabli-hosted; redirects off-site, less customizable. Do not embed it in an iframe. https://docs.payabli.com/guides/pay-in-payment-page-overview.md
  • Direct API — the partner integrates the payment API directly and handles card data themselves, which raises their PCI responsibility. Follow Payabli's PCI best practices. https://docs.payabli.com/guides/platform-pci-best-practices-overview.md
PCI is not legal advice. Payabli's PCI materials are engineering best practices, not legal or compliance advice. Do not advise the partner on PCI compliance, scope determination, or audits. Direct specific PCI questions to the Payabli team.

If using embedded components, pick the component:

ComponentUse forPayabliExec actions
EmbeddedMethod UIcharge or save a method (most flexible)pay, method, reinit
ExpressCheckout UIdigital wallets (Apple Pay, Google Pay)pay, method, reinit

Component guides: https://docs.payabli.com/guides/pay-in-components-embeddedmethod-ui.md · https://docs.payabli.com/guides/pay-in-components-express-checkout.md

Components authenticate with a public token, passed in the component config — not your private (server-side) API token. Public tokens are publicly readable and safe to ship to the browser; never put a private token in client-side code. (Creator components require a public token with domain restrictions.) https://docs.payabli.com/developers/api-reference/api-overview.md

Framework/bundler gotcha: PayabliComponent is a global symbol — instantiate it as new PayabliComponent({...}), not window.PayabliComponent. If the constructor isn't found, the component shows a misleading "couldn't load / check network and token" even though the script loaded — check the global access first. When server-side rendering, use a stable component container identifier. See https://docs.payabli.com/guides/pay-in-developer-components-frameworks.md

PayMethod UI (a save-method-only lightbox) is also available, but it is less flexible than EmbeddedMethod UI and is not a default choice. https://docs.payabli.com/guides/pay-in-components-paymethod-ui.md

Step 2 — Make the charge

A one-time sale authorizes and captures in one call: POST /v2/MoneyIn/getpaid. Use the v2 endpoints — v1 is being deprecated. Send an idempotencyKey on this call (see payabli-fundamentals). https://docs.payabli.com/guides/pay-in-developer-transactions-create.md

If a sandbox charge returns E9999 ("Unexpected error"), check the response before retrying: cvvresponse: "N" means a valid card with the wrong CVV (fix the CVV), otherwise the card likely isn't a valid Payabli test card — retry with a canonical one from payabli-testing.

Separate authorize then capture when you must confirm before taking funds (for example, verifying availability or finalizing the amount). https://docs.payabli.com/guides/pay-in-developer-transactions-auth-capture.md

Step 3 — Know the lifecycle

A transaction moves Authorized → Captured → batch close → in transit → funded, and is largely final once its batch closes. This drives the reversal choice below. https://docs.payabli.com/guides/pay-in-transactions-lifecycle-overview.md

When you query a transaction, its state comes back as a numeric TransStatus (for example, 1 = approved/captured, 11 = authorized, 5 = voided/canceled). Map the full set — including declines and rejections — with the Pay In status reference. https://docs.payabli.com/guides/pay-in-status-reference.md

Step 4 — Reverse a payment: void vs. refund

Check settlement status first:

  • Void an unsettled transaction (before batch close) — avoids interchange fees; funds never leave the customer.
  • Refund a settled transaction (after batch close) — partial refunds are allowed.

https://docs.payabli.com/guides/pay-in-transactions-void-vs-refund-decision.md

A refund that fails (errors or later reverses) is recovery work — use payabli-disputes, not this skill.

To test a refund in sandbox you need a settled transaction, and reaching settled/funded requires a Payabli-side funding trigger (see payabli-testing).

ACH

Use the same /v2/MoneyIn/getpaid flow with an ACH method. Unlike cards, ACH settles over multiple days and can return after the fact, so confirm final status before treating a payment as good. Return codes: https://docs.payabli.com/guides/platform-ach-return-codes-reference.md · cycle: https://docs.payabli.com/guides/pay-in-ach-cycle-overview.md

Digital wallets

Apple Pay and Google Pay run through ExpressCheckout UI and require domain registration before use. https://docs.payabli.com/guides/pay-in-wallets-apple-pay-overview.md · https://docs.payabli.com/guides/pay-in-wallets-google-pay-overview.md

Customers

Customers are foundational to Pay In, not only to tokenization. Create one with POST /Customer/single/{entry}; each paypoint keeps its own customer list (customers are not shared across paypoints). You can't charge without a customer, so this is usually the first call. https://docs.payabli.com/guides/pay-ops-developer-customers-manage.md

When charging through an embedded component (payabliExec('pay')), pass the existing customerId in customerData so the charge links to that customer instead of creating a new one.

Body-shape gotcha: the create-customer body is flat — firstname, email, and the rest sit at the top level, not wrapped in customerData the way the transaction endpoints nest them. Include an identifierFields array plus at least one of the paypoint's configured identifiers (see payabli-fundamentals → Customer identifiers).

To save a payment method for reuse, use payabli-tokenization.

Other surfaces

Card-present devices, remote deposit capture, IVR, Level 2/3 data, and split funding are covered in references/other-surfaces.md.

Boundaries

  • Recurring billing / autopay → payabli-subscriptions
  • Invoices and customer payment links → payabli-invoices
  • Chargebacks, disputes, and refund-failure recovery → payabli-disputes
같은 저장소의 Skills

더 많은 Skills

모든 Skills
payabli
커뮤니티

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.

1시간 설치 수
1
GitHub Stars
0
업데이트
10월 23일
payabli
커뮤니티

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.

1시간 설치 수
1
GitHub Stars
0
업데이트
10월 23일
payabli
커뮤니티

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.

1시간 설치 수
1
GitHub Stars
0
업데이트
10월 23일
payabli
커뮤니티

payabli-certification-prep

Use when a partner wants to rehearse the Payabli certification test scenarios in sandbox before their certification call — running the checks they can self-serve and confirming expected results. This is prep for the call, not self-certification (certification happens with a Payabli SE). Reads payabli-integration.md on load if present.

1시간 설치 수
1
GitHub Stars
0
업데이트
10월 23일