Developers / Pay Buttons / Creating Dynamic Buttons
Creating dynamic buttons

Creating Dynamic Buttons

To dynamically create a "Pay Now" / "Subscribe" button you have to create a HTML FORM that creates a POST request to the following URL:

https://www.paxum.com/payment/phrame.php?action=displayProcessPaymentLogin

"Pay Now" fields:

Field Name Len Type Comments
business_email N/A Alp-Num Mandatory. This is a verified email address attached to your account
business_logo_id N/A Num Optional. ID of a logo defined within your account in My Account >> Profile Settings >> Business Logos taht will be used to customize the payment confirmation page. If this field is not specified the default logo defined in your account is used. If this field is not specified and there is no logo defined within your account, no logo will be displayed.
button_type_id N/A Num Mandatory. 1= Pay Now button; 2 = Subscribe button
item_id N/A Alp-Num Optional. An internal ID from your system
item_name N/A Alp-Num Mandatory. Name of the item that will be displayed to the buyer on the payment confirmation page
amount N/A Num Mandatory. The amount the buyer will be charged.
currency 3 Alp Mandatory. Three letter currency code: USD, EUR, CAD, etc (for now only USD is allowed)
shipping N/A Num Optional. Shipping amount the buyer will be charged
tax N/A Num Optional. Tax percent the buyer will be charged
change_quantities 1 Num Optional. Allow the buyer to change quantities on the payment confirmation page. 1 = Yes; 2 = No; default value is 2
special_instructions 1 Num Optional. Allow the buyer to add special instruction on the payment confirmation page. 1 = Yes; 2 = No; default value is 2
ask_shipping 1 Num Optional. Ask the buyer to enter shipping address on the payment confirmation page. 1 = Yes; 2 = No; default value is 2
cancel_url N/A Alp-Num Optional. URL where the buyer is redirected if the payment is canceled. If not specified the buyer is taken to our website.
finish_url N/A Alp-Num Optional. After the payment is successful the buyer will have an option to return to the merchant website. This is the Merchant's website URL. If not specified the buyer will not have this option
variables N/A Alp-Num Optional. Other variables to be submitted as field=value pairs separated by &.
notify_url=https://www.mystore.com/ipn/
Add notify_url if you want to receive an instant payment notification (IPN) after the transaction was completed successfuly.

"Subscribe" specific fields (when button_type_id = 2 = subscription):

Field Name Len Type Comments
payment_interval N/A Num Subscription payment periodicity:
1 = Every Week
2 = Every Two Weeks
3 = Every Month
4 = Every Three Months
5 = Every Six Months
6 = Anually
end_date N/A Date/Time Depends*. The subscription will be automatically canceled at this date.
user_cancel N/A Num Depends*. The subscription will be active until the user cancels it. Value of this field should be 1.
transfers N/A Num Depends*. The subscription will be automatically canceled after the number of transfers specified here.

* one of these fields is mandatory

Pay Now Fields :

Field Name Len Type Comments
cfl_N N/A Alp-Num Optional. Custom field label.
This is your name of the custom field. The user will be asked to enter a value for this field.
cfv_N N/A Alp-Num Optional. Custom field value.
This field will contain the value entered by user for label cfl_N.