Skip to content

docs: add complete API reference for fx-account and fx-payment#3

Merged
marioalvial merged 4 commits intomainfrom
docs/fx-payment-api-reference
Apr 14, 2026
Merged

docs: add complete API reference for fx-account and fx-payment#3
marioalvial merged 4 commits intomainfrom
docs/fx-payment-api-reference

Conversation

@marioalvial
Copy link
Copy Markdown
Contributor

Description

Add full OpenAPI specs and API reference pages for both fx-account (12 endpoints) and fx-payment (12 endpoints), giving customers a complete, navigable API reference for the Trace FX platform.

Key Changes

  • Complete fx-payment OpenAPI spec with 34 schemas, 7 reusable parameters, and 12 fully documented endpoints (deposits, withdrawals, swaps, operations, beneficiaries, payment instructions)
  • Add 12 fx-payment MDX reference pages with openapi: frontmatter for auto-rendering
  • Add Operations, Beneficiaries, and Payment Instructions groups to the API Reference tab in docs.json
  • Include fx-account OpenAPI spec (12 endpoints) and 12 MDX reference pages
  • Fix swap journey to use correct POST /api/swaps endpoint instead of non-existent POST /api/quotes

Type of change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update

How Has This Been Tested?

  • Unit Test
  • Integration Test

OpenAPI spec validated: 12 endpoints with zero TODO stubs, 102 $ref references all resolve, valid YAML/JSON structure. All docs.json navigation pages verified to exist on disk.

Checklist:

  • My code follows the style guidelines of this project
  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes
  • Any dependent changes have been merged and published in downstream modules
  • I have checked my code and corrected any misspellings

Replace all 12 TODO stubs with full request/response schemas,
reusable parameters, and examples for deposits, withdrawals,
swaps, operations, beneficiaries, and payment instructions.
Create 12 MDX stub pages for operations and beneficiary endpoints
with openapi frontmatter directives. Add Operations, Beneficiaries,
and Payment Instructions groups to the API Reference tab in docs.json.
Remove reference to non-existent POST /api/quotes endpoint.
The quote is created automatically when creating a swap and
returned in the response.
Include the complete fx-account OpenAPI spec with all 12 endpoint
schemas and 12 MDX stub pages for account, UBO, document, and
funding instruction endpoints.
@mintlify
Copy link
Copy Markdown

mintlify bot commented Apr 14, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
tracefinance 🟢 Ready View Preview Apr 14, 2026, 11:52 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@marioalvial marioalvial merged commit 29f325b into main Apr 14, 2026
8 checks passed
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