References

Initiate Payment Parameters

Parameter	Type	Required	Description
orderId	String	Yes	Unique order ID for the transaction (min. 4 characters)
price	Integer	Yes	Purchase price in the smallest currency unit (e.g., cents)
countryCode	Enum	Yes	ISO 3166-1 alpha-2 country code (e.g., Coda.CountryCode.US)
currencyCode	Enum	Yes	ISO 4217 currency code (e.g., Coda.CurrencyCode.USD)
userId	String	Yes	Unique user identifier
itemName	String	No	Name of the item being purchased
itemCode	String	No	Unique code for the item being purchased
dynamic_descriptor	String	No	Appears on the user's card/bank statement
webhookUrl	String	No	URL for receiving payment status callback
returnUrl	String	No	URL to redirect the user to after payment completion
priceIncludesTax	Boolean	No	Indicates if the price includes tax (default is

Event Listeners

Event Name	Description
OnPriceChanged	Triggered when the price is updated due to tax adjustments.
OnPurchaseFailed	Triggered when a purchase transaction fails, providing an error message.
OnPurchaseSuccess	Triggered when a purchase transaction is successfully completed.
OnPaymentInitiated	Triggered when a payment request is initiated.
OnPaymentCancelled	Triggered when a user cancels the payment process.
OnPaymentPending	Triggered when a payment is in progress but not yet confirmed.