
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) |