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 that 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
ask_phone 1 Num Optional. Ask the buyer to enter his phone on the payment confirmation page. 1 = Yes; 2 = No; default value is 2
ask_name 1 Num Optional. Ask the buyer to enter his name 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.
merchant_id N/A Num Optional. ID of merchant defined within your account in Merchant Services >> Merchant Accounts, this ID is showing what merchant should be used for this button. If this field is not specified it means there is no merchant.
reference_id N/A Alp-Num Optional. An internal ID of your system to identify the transaction.
button_action N/A Alp-Num Optional. This field is used only for card transactions. 1 = only authorisation, 2 = both authorisation and settlement. Default is 2.

"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.

Pay By Card:

Field Name Len Type Comments
card_name 64 Alp Optional. Name On Card
card_billing_email 40 Alp-Num Optional. Billing Email
card_billing_street_name 32 Alp-Num Optional. Billing Street Name
card_billing_street_number 15 Alp-Num Optional. Billing Street Number
card_billing_building N/A Alp-Num Optional. Billing Building
card_billing_entrance N/A Alp-Num Optional. Billing Entrance
card_billing_floor N/A Alp-Num Optional. Billing Floor
card_billing_apartment N/A Alp-Num Optional. Billing Apartment
card_billing_district N/A Alp-Num Optional. Billing District
card_billing_city N/A Alp-Num Optional. Billing City
card_billing_postal_code N/A Alp-Num Optional. Billing Zip (Postal Code)
card_billing_country 2 Alp-Num Optional. Billing Country - two letters country code (ISO Char 2 Code)
card_billing_state 2/3 Alp-Num Optional. Billing State - two/tree letters state / province / county code (ISO 3166-2)