Clearway Documentation
  • Home
  • Guides
  • Merchant API
  • Investor Read API
Back to Merchant APIInformation
Analytics
    Read analyticspost
Checkout
    Create checkout sessionspostCreate payment intentpost
Customers
    Manage customerspost
Orders
    Get orderpostRead orderspost
Payment links
    Create payment linkspostList payment linkspost
Payments
    Preview platform feespostProcess refundspostResolve embed displaypost
Products
    Write merchant couponspostWrite productspostDelete productpostGet productpostRead merchant couponspostRead productspostUpdate merchant couponpostUpdate productpost
Subscriptions
    Cancel subscriptionspostChange subscription planspostRead subscriptionspostPreview subscription plan changespost
Schemas
powered by Zudoku
Clearway Documentation
Clearway Documentation

Payments

Download schema

Preview platform fees

POST
https://api-dev.clearway.to
/PREVIEW_PLATFORM_FEE

Simulate Clearway platform fees and wallet impact for a hypothetical charge amount without creating payment objects.

Preview platform fees › Headers

x-cid
​string

Optional correlation id for support trails.

x-brand-id
​string

Optional platform brand slug for multi-brand merchants.

Preview platform fees › Request Body

amountCents
​number
currency
​string
Additional properties are allowed

Preview platform fees › Responses

Success

MerchantApiSuccessEnvelope
success
​boolean · required
Additional properties are allowed
POST/PREVIEW_PLATFORM_FEE
curl https://api-dev.clearway.to/PREVIEW_PLATFORM_FEE \ --request POST \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <token>' \ --data '{ "amountCents": 50000, "currency": "USD" }'
Example Request Body
{ "amountCents": 50000, "currency": "USD" }
json
application/json
Example Responses
{ "success": true }
json
application/json

Process refunds

POST
https://api-dev.clearway.to
/PROCESS_MERCHANT_REFUND

Issue full or partial refunds on paid destination charges (reverse_transfer). Requires a client idempotency token per attempt.

Process refunds › Headers

Idempotency-Key
​string · required

Stable key for safe retries on money-moving requests.

x-cid
​string

Optional correlation id for support trails.

x-brand-id
​string

Optional platform brand slug for multi-brand merchants.

Process refunds › Request Body

orderId
​string
idempotencyToken
​string
refundType
​string
reason
​string
Additional properties are allowed

Process refunds › Responses

Success

MerchantApiSuccessEnvelope
success
​boolean · required
Additional properties are allowed
POST/PROCESS_MERCHANT_REFUND
curl https://api-dev.clearway.to/PROCESS_MERCHANT_REFUND \ --request POST \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: <string>' \ --header 'Authorization: Bearer <token>' \ --data '{ "orderId": "00000000-0000-4000-8000-000000000001", "idempotencyToken": "00000000-0000-4000-8000-000000000002", "refundType": "full", "reason": "requested_by_customer" }'
Example Request Body
{ "orderId": "00000000-0000-4000-8000-000000000001", "idempotencyToken": "00000000-0000-4000-8000-000000000002", "refundType": "full", "reason": "requested_by_customer" }
json
application/json
Example Responses
{ "success": true }
json
application/json

Resolve embed display

POST
https://api-dev.clearway.to
/RESOLVE_EMBED_DISPLAY

Resolve tamper-safe catalog display payloads for Clearway Elements product cards and subscription modals.

Resolve embed display › Headers

x-cid
​string

Optional correlation id for support trails.

x-brand-id
​string

Optional platform brand slug for multi-brand merchants.

Resolve embed display › Request Body

catalogProductId
​string
theme
​string
Additional properties are allowed

Resolve embed display › Responses

Success

MerchantApiSuccessEnvelope
success
​boolean · required
Additional properties are allowed
POST/RESOLVE_EMBED_DISPLAY
curl https://api-dev.clearway.to/RESOLVE_EMBED_DISPLAY \ --request POST \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <token>' \ --data '{ "catalogProductId": "prod_example", "theme": "minimal" }'
Example Request Body
{ "catalogProductId": "prod_example", "theme": "minimal" }
json
application/json
Example Responses
{ "success": true }
json
application/json

Payment linksProducts