input CreatePaymentSessionInput

FieldTypeDescription
orgIdID!Organization identifier the payment session belongs to.
amountAmount!Total payment amount. Ex. 100.10
currencyCurrency!Three letter ISO currency code. Ex. USD
callbackUrlURLURL to receive payment session events
successUrlURLURL to redirect after a payment session is completed by the customer
contactIdIDOptional contact for which this payment session is attached. You cannot provide both a contactId and a contactRef. Note that some features are unavailable if a contactId or contactRef is not provided.
contactRefPaymentSessionContactRefInputOptional merchant supplied reference contact information external to the platform. You cannot provide both a contactId and a contactRef. Note that some features are unavailable if a contactId or contactRef is not provided.
transactionRefStringOptional merchant supplied reference ID for the transaction external to the platform.
invoiceIds[String!]Optional array of invoice IDs which this payment session is attached to. You cannot provide both invoiceIds and invoiceRefs. Note that some feature are unavailable unless at least one invoiceId or invoiceRef is provided.
invoiceRefs[PaymentSessionInvoiceRefInput!]Optional array of invoice references which this payment session is attached to. You cannot provide both invoiceIds and invoiceRefs. Note that some features are unavailable unless at least one invoiceId or invoiceRef is provided.
expirationDateDateTimeOptional expiration date for the payment session. ISO 8601 format.
createPendingPaymentBooleanOptionally create a pending payment record for this payment session. Default is false which means a payment record is created upon payment session completion. Set this to true if you require a pending payment to be visible in the payment list in the dashboard before payments are made. This is useful for use cases involving payment sessions without expirations. This setting may only be set on payment session creation.
checkoutConfigurationIdIDThe checkout configuration ID to be used for this payment session. If a checkout configuration ID is not provided, the default checkout configuration will be used.
invoiceTotalAmountOptional total amount due across the referenced invoices. When the payment amount exceeds this total (for example because of a surcharge or tip), financing options such as FlexPay are disabled since they cannot finance the additional amount.
brandLogoUrlURLOptional URL to a logo image to display during checkout, overriding the default branding. The caller supplies a URL that is used to render the logo.
brandNameStringOptional brand or merchant name to display during checkout, overriding the organization name.