# FluxA API

**Canonical:** https://apis.io/apis/fluxapay-xyz/fluxapay-xyz-api/  
**Provider:** FluxA — https://apis.io/providers/fluxapay-xyz/  
**Base URL:** https://walletapi.fluxapay.xyz  
**Documentation:** https://docs.fluxapay.xyz/wallet/api/refunds/get-refund.html

FluxA API is one of 2 APIs that [FluxA](https://apis.io/providers/fluxapay-xyz/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

FluxA API as documented publicly: 16 operations. Contract generated from the documentation by API Evangelist (2026-11-04); not the provider's own document.

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| POST | `/agent/update` | Update an agent name |
| POST | `/agent/vc/issue` | Issue an agent Verifiable Credential |
| GET | `/api/mandates` | List agent mandates |
| GET | `/api/mandates/agent/{mandateid}` | Get mandate by ID |
| POST | `/api/mandates/create-intent` | Create intent mandate |
| GET | `/api/payment-links/refunds` | List refunds |
| POST | `/api/payment-links/refunds/initiate` | Create a pending refund for a settled payment and get a refundUrl (valid 24 h) to pay over x402. |
| GET | `/api/payment-links/refunds/{refundid}` | Get refund detail |
| POST | `/api/payment-links/refunds/{refundid}/cancel` | Cancel refund |
| POST | `/api/payment/{paymentid}` | Authorize a single x402 payment |
| POST | `/api/payouts` | Create payout |
| POST | `/api/v2/payment/x402-payment` | Pay x402 v2 payment requirements with a mandate |
| POST | `/refresh` | Refresh the login JWT |
| GET | `/refundlink/{refundid}` | Pay a refund link (public x402) |
| POST | `/register` | Register an agent |
| POST | `/verify-vc` | Verify an agent VC |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/fluxapay-xyz/openapi/_ae-authored/fluxapay-xyz-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/fluxapay-xyz/json-schema/fluxapay-xyz-post-api-payment-paymentid-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/fluxapay-xyz/json-schema/fluxapay-xyz-get-api-payment-links-refunds-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/fluxapay-xyz/json-schema/fluxapay-xyz-get-api-payment-links-refunds-refundid-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/fluxapay-xyz/json-schema/fluxapay-xyz-post-api-payouts-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/fluxapay-xyz/json-schema/fluxapay-xyz-post-api-payment-links-refunds-initiate-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/fluxapay-xyz/json-schema/fluxapay-xyz-get-api-mandates-agent-mandateid-response-schema.json

## Other FluxA APIs (1)

- [FluxA Wallet API](https://apis.io/apis/fluxapay-xyz/fluxa-wallet-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/fluxapay-xyz/fluxapay-xyz-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/fluxapay-xyz/.