@xapps-platform/payment-hosted-client

Browser-safe hosted payment client for gateway payment flows.

Install

npm install @xapps-platform/payment-hosted-client

When to use it

Use this package in browser payment pages or embedded checkout flows that need to talk to the gateway hosted payment endpoints without pulling in provider adapters or backend-only logic.

Status:

• prepared for public distribution as the external browser payment integration surface

This package wraps the gateway hosted payment endpoints:

• GET /v1/gateway-payment/session
• POST /v1/gateway-payment/complete
• POST /v1/gateway-payment/client-settle

Contract notes:

• hosted method negotiation is canonical session.accepts[] (do not read legacy metadata aliases)
• completeSession may return flow=client_collect with client_settle_url; client-settle can use that explicit URL
• hosted ui fields are presentation-only and never authority for settlement/signing

It is intentionally protocol/UI-focused and excludes:

• provider adapter logic
• provider credentials/secrets
• provider credential bundle refs
• signing or policy authority behavior

Usage

import { createHostedPaymentClient } from "@xapps-platform/payment-hosted-client";

const client = createHostedPaymentClient();
const session = await client.getSession({ paymentSessionId: "pay_123" });
const result = await client.completeSession({ paymentSessionId: "pay_123" });

Related packages

• @xapps-platform/server-sdk for backend-side gateway orchestration
• xapps-platform/xapps-php for PHP backend integrations
• @xapps/payment-providers for provider-adapter implementations

Verify locally

npm run build --workspace packages/payment-hosted-client
npm run smoke --workspace packages/payment-hosted-client