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 NameLenTypeComments
business_emailN/AAlp-NumMandatory. This is a verified email address attached to your account
business_logo_idN/ANumOptional. 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_idN/ANumMandatory. 1= Pay Now button; 2 = Subscribe button
item_idN/AAlp-NumOptional. An internal ID from your system
item_nameN/AAlp-NumMandatory. Name of the item that will be displayed to the buyer on the payment confirmation page
amountN/ANumMandatory. The amount the buyer will be charged.
currency3AlpMandatory. Three letter currency code: USD, EUR, CAD, etc (for now only USD is allowed)
shippingN/ANumOptional. Shipping amount the buyer will be charged
taxN/ANumOptional. Tax percent the buyer will be charged
change_quantities1NumOptional. Allow the buyer to change quantities on the payment confirmation page. 1 = Yes; 2 = No; default value is 2
special_instructions1NumOptional. Allow the buyer to add special instruction on the payment confirmation page. 1 = Yes; 2 = No; default value is 2
ask_shipping1NumOptional. Ask the buyer to enter shipping address on the payment confirmation page. 1 = Yes; 2 = No; default value is 2
ask_phone1NumOptional. Ask the buyer to enter his phone on the payment confirmation page. 1 = Yes; 2 = No; default value is 2
ask_name1NumOptional. Ask the buyer to enter his name on the payment confirmation page. 1 = Yes; 2 = No; default value is 2
cancel_urlN/AAlp-NumOptional. URL where the buyer is redirected if the payment is canceled. If not specified the buyer is taken to our website.
finish_urlN/AAlp-NumOptional. 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
variablesN/AAlp-NumOptional. 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_idN/ANumOptional. 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_idN/AAlp-NumOptional. An internal ID of your system to identify the transaction.
button_actionN/AAlp-NumOptional. 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 NameLenTypeComments
payment_intervalN/ANumSubscription payment periodicity:
1 = Every Week
2 = Every Two Weeks
3 = Every Month
4 = Every Three Months
5 = Every Six Months
6 = Anually
end_dateN/ADate/TimeDepends*. The subscription will be automatically canceled at this date.
user_cancelN/ANumDepends*. The subscription will be active until the user cancels it. Value of this field should be 1.
transfersN/ANumDepends*. The subscription will be automatically canceled after the number of transfers specified here.

* one of these fields is mandatory


Pay Now Fields :

Field NameLenTypeComments
cfl_NN/AAlp-NumOptional. Custom field label.
This is your name of the custom field. The user will be asked to enter a value for this field.
cfv_NN/AAlp-NumOptional. Custom field value.
This field will contain the value entered by user for label cfl_N.

Pay By Card:

Field NameLenTypeComments
card_name64AlpOptional. Name On Card
card_billing_email40Alp-NumOptional. Billing Email
card_billing_street_name32Alp-NumOptional. Billing Street Name
card_billing_street_number15Alp-NumOptional. Billing Street Number
card_billing_buildingN/AAlp-NumOptional. Billing Building
card_billing_entranceN/AAlp-NumOptional. Billing Entrance
card_billing_floorN/AAlp-NumOptional. Billing Floor
card_billing_apartmentN/AAlp-NumOptional. Billing Apartment
card_billing_districtN/AAlp-NumOptional. Billing District
card_billing_cityN/AAlp-NumOptional. Billing City
card_billing_postal_codeN/AAlp-NumOptional. Billing Zip (Postal Code)
card_billing_country2Alp-NumOptional. Billing Country - two letters country code (ISO Char 2 Code)
card_billing_state2/3Alp-NumOptional. Billing State - two/tree letters state / province / county code (ISO 3166-2)