Public API (v1)
Sessions

Create Session

Create a new payment session.

Returns minimal identifiers needed for polling.

Pass ?response_status=200 if your platform does not accept HTTP 201.

Authentication: API Key (Bearer token)

post/v1/sessions

Request

  • Base URL: https://api.trymaven.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.trymaven.com/v1/sessions
  • Auth: HTTP bearer

Query parameters

response_statusinteger nullable

Override the HTTP status code (e.g. 200). Some voice platforms only accept 200 as success.

Request body

projectstring required

Project identifier (UUID or slug)

callerstring required

Phone number in E.164 format

mode'charge' | 'tokenize' required

Payment mode.

gateway'stripe' | 'authorizenet' | 'braintree' | 'shift4' | 'fiserv' | 'jpmorgan' | 'webhook' | 'nmi' | 'qualpay' | 'clover' | 'adyen' | 'checkoutcom' | 'cybersource' | 'worldpay' | 'usaepay' | 'moneris' | 'globalpayments' | 'cardconnect' | 'paysafe' | 'fortis' | 'payflow' | 'opayo' | 'fatzebra' | 'trustpayments' | 'quickbooks' | 'ecommpay' required

Payment gateway.

descriptionstring nullable

Charge description

callbackstring nullable

Callback phone number or SIP URI for transfer-back

memorystring nullable

Call context passed back on transfer

stripe_accountstring nullable

Stripe Platform Mode only: the connected account (acct_...) on YOUR Stripe platform to charge or vault on. Requires your platform API key to be configured on the project.

Response

Successful Response

session_idstring required

Session UUID

statusstring required

Session status

phone_numberstring nullable

IVR phone number to call

sip_uristring nullable

Twilio SIP domain for SIP calls

created_atstring date-time required

Creation timestamp

Changes

No recorded changes to this operation across all 1 revision of this API.