docs(secure-payments): add integration guide and refine secure payment docs for practical implementation

[aimensahnoun]

Add Secure Payment Integration Guide with end-to-end implementation examples

This PR adds a comprehensive integration guide for Secure Payment Pages that covers:

• End-to-end integration flow with a webhook-driven architecture
• Prerequisites for production setup: API key or Client ID, webhook endpoint, and webhook signing secret
• Practical quickstart steps for creating secure payment links, storing requestIds, redirecting payers, and processing webhooks
• Implementation-ready code snippets for:
  • URL generation with the API
  • Redirect patterns (same tab/new tab options)
  • Webhook signature verification with request reconciliation
• Documentation on link expiry behavior (one week default) with renewal flow guidance
• Troubleshooting section for common integration issues (auth errors, token expiry, completed payments, webhook processing)

The guide is designed to be compatible with both frontend (Client ID) and backend integration patterns, focusing on product behavior rather than implementation specifics.

The new guide is added to the existing Secure Payment Pages section in the navigation structure.

Summary by CodeRabbit

• Documentation
  • Added comprehensive guide for secure payment integration covering the complete payment flow, including creating secure payment links, redirecting users, processing webhooks for status updates, handling link expiry, and troubleshooting common integration issues with code examples.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between c2b492d and 4b097f1.

📒 Files selected for processing (2)

• api-features/secure-payment-integration-guide.mdx
• docs.json

---

Walkthrough

A new secure payment integration guide has been added to the documentation, covering API integration patterns, webhook handling, prerequisite setup, and expiry management. The corresponding navigation configuration has been updated to include this new documentation page.

Changes

Cohort / File(s)	Summary
Documentation api-features/secure-payment-integration-guide.mdx	New comprehensive integration guide covering secure payment link creation via POST /v2/secure-payments, database persistence, webhook verification using HMAC-SHA256, payment status mapping, link expiry handling (one week), and troubleshooting for common errors. Includes Node.js/Express backend examples and frontend redirect patterns.
Navigation Configuration docs.json	Added new documentation page entry under "Secure Payment Pages" group within API Features navigation structure.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch 02-13-docs_secure-payments_add_integration_guide_and_refine_secure_payment_docs_for_practical_implementation

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[aimensahnoun]

• docs(secure-payments): add integration guide and refine secure payment docs for practical implementation #49 👈 (View in Graphite)
• docs(secure-payments): add standalone Secure Payment Pages docs and API reference, clarify support model, and simplify integration guidance #48
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[greptile-apps]

Greptile Overview

Greptile Summary

This PR adds a comprehensive Secure Payment integration guide that provides end-to-end implementation examples for webhook-driven payment flows. The guide covers prerequisites, quickstart steps, practical code snippets for URL generation and redirect patterns, webhook signature verification with request reconciliation, link expiry handling, and troubleshooting common integration issues. The documentation follows Mintlify style guidelines with proper component usage (<Steps>, <CodeGroup>, <AccordionGroup>, <CardGroup>), clear structure, and actionable code examples. The navigation structure has been correctly updated to include the new guide within the Secure Payment Pages section.

Confidence Score: 5/5

• This PR is safe to merge with no issues identified
• The PR adds documentation-only changes with well-structured content that follows established style guidelines. Code examples are properly formatted, secure (using environment variables for secrets), and follow best practices (HMAC signature verification, timing-safe comparison). No logic errors, syntax issues, or security vulnerabilities present.
• No files require special attention

Important Files Changed

Filename	Overview
api-features/secure-payment-integration-guide.mdx	New comprehensive integration guide added with webhook-driven architecture, code examples, and troubleshooting. Well-structured and follows style guidelines.
docs.json	Navigation structure updated to include new integration guide page within Secure Payment Pages group.

_{Last reviewed commit: abca038}

[greptile-apps]

_{2 files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}

[bassgeta]

Payment status: secure ✅

[aimensahnoun]

Merge activity

• Feb 23, 1:19 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• Feb 23, 1:20 PM UTC: Graphite rebased this pull request as part of a merge.
• Feb 23, 1:21 PM UTC: @aimensahnoun merged this pull request with Graphite.