Skip to content

feat(skill): TurboQuote payments in the agentic quickstart - #10

Draft
nicolasiscoding wants to merge 5 commits into
mainfrom
feat/turboquote-payments-skill
Draft

feat(skill): TurboQuote payments in the agentic quickstart#10
nicolasiscoding wants to merge 5 commits into
mainfrom
feat/turboquote-payments-skill

Conversation

@nicolasiscoding

Copy link
Copy Markdown
Member

Summary

Adds the collect-payment-on-quotes path to the /turbodocx-sdk skill. (Layered on the TurboQuote-skill branch; that work is included in this draft's diff vs main.)

Payments changes (this PR's focus):

  • SKILL.md — generate the payments path when a user asks to get paid / pay link / checkout on quotes: getPaymentConnectionStatus (gate on chargesEnabled), createPaymentLink, getPaymentStatus, and a quote.payment.succeeded webhook handler (verifyWebhookSignature + TURBODOCX_WEBHOOK_SECRET). Provider onboarding stays a one-time UI step.
  • references/javascript.md — 'Online payments' section.
  • evals/evals.json — eval #29 (pay link + status + verified webhook; asserts no onboarding calls).

Status

Backed by the implemented + live-verified backend/SDK payments feature. JS/TS first; Python/Go/PHP/Java references + evals + an eval-suite run to follow. Draft.

- SKILL.md: opt-in product paragraph, /turbodocx-sdk turboquote shortcut,
  Phase 6.4 generate block, description + version bump (1.4.0 -> 1.5.0)
- references/{javascript,python,go,php,java}.md: full TurboQuote section
  (configure with apiKey+orgId/no senderEmail, key methods, 47-method
  reference table, gotchas) mirroring the TurboWebhooks sections
- env-vars.md: TurboQuote shares TURBODOCX_API_KEY + TURBODOCX_ORG_ID
- evals/evals.json: 5 TurboQuote evals (Express, FastAPI, Laravel, Go
  net/http, Spring Boot)
- plugin.json: version + description + keywords
createPriceBook now includes all four required fields (name, priceBookTypeId, validFrom, discountPercent); createProduct/createBundle include required categoryId + item unitPrice/billingFrequency; addBundleLineItems includes bundleName; custom line items send explicit productId null; removed a non-existent 'notes' field on createQuote. Verified against SDK source + live backend.
Adds references/ruby.md (TurboSign, Deliverable, TurboPartner, TurboWebhooks,
TurboQuote) authored from the real Ruby SDK, wires Ruby into SKILL.md
(Gemfile/gemspec detection, bundler/gem install, Phase 5 reference, coverage
lines, shortcuts, frontmatter), and adds Ruby evals 29-31 (Rails+TurboSign,
Rails+Webhooks, Sinatra+Deliverable). Eval run: 100% pass, ~41% faster /
22% fewer tokens vs the pre-Ruby baseline.
- SKILL.md: scaffold the payments path when a user asks to collect payment on
  quotes — getPaymentConnectionStatus (gate), createPaymentLink, getPaymentStatus,
  and a quote.payment.succeeded webhook handler (verifyWebhookSignature +
  TURBODOCX_WEBHOOK_SECRET). Onboarding stays a one-time UI step, not the SDK.
- references/javascript.md: 'Online payments' section (link/status/connection +
  webhook handler).
- evals.json: eval #29 for the payments scenario.

JS/TS first; Python/Go/PHP/Java references + evals to follow.
@nicolasiscoding

Copy link
Copy Markdown
Member Author

SDK PR: TurboDocx/SDK#35 (draft) — JS SDK payments methods + runnable E2E example (verified live).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant