Difference between revisions of "Itelebill"
From TMM Wiki
Jump to navigationJump to search (Created page with '== Setting up with Itelebill (ITELEBILL) == Go to www.itelebill.com and create an account. Once you're account has been created you can login and create a new standard payment z…') |
|||
| (7 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
| + | {{NATS5 Manual | ||
| + | |show_billers_section = true | ||
| + | }} | ||
| + | {{NATS4 Manual}} | ||
| + | |||
== Setting up with Itelebill (ITELEBILL) == | == Setting up with Itelebill (ITELEBILL) == | ||
| − | + | Before you can set up Itelebill in [[NATS4]], you must first create an account through them. You can do so by going to their website at www.itelebill.com. After your account has been created, you will be able to log in and create a new standard payment zone by using the form provided at the bottom. | |
| − | |||
| − | + | In the Payment Zone Editor, you should configure the available values as follows: | |
| − | * Payment Zone Type: | + | * Payment Zone Type: Standard Product Payment |
| − | * Web Address: | + | * Web Address: The URL to your website, eg: www.example.org |
| − | * Name of Website: | + | * Name of Website: The name of your website, eg: Example Website |
| − | * Access Period: | + | * Access Period: If you want to use PRS, this will determine the length of subscription, eg: 28 days. |
| − | * Access Period Extra Free: | + | * Access Period Extra Free: None |
| − | * Access Period Type: | + | * Access Period Type: Either 'After Payment Only', or 'While Connected Only' |
| − | * Early SMS Grant: | + | * Early SMS Grant: Do not send early grant |
| − | * Early SMS Revoke: | + | * Early SMS Revoke: Do not send early revoke |
| − | * Testing Mode: | + | * Testing Mode: Do not allow simulated payments |
* Local Currency Conversion: Disabled | * Local Currency Conversion: Disabled | ||
| − | * Local Time Conversion: | + | * Local Time Conversion: Universal Coordinated Time |
| + | * PRS Payment: Enabled if you want PRS telephone call payment, otherwise disabled | ||
| + | * PRS Minutes: The required number of minutes the user must stay on the telephone to complete the transaction | ||
| + | * SMS Payment: Whether you would like to take payment by SMS | ||
| + | * SMS Rebilling: Enabled. This can be configured by the NATS control panel | ||
| + | * Authentication System: I have my own authentication system | ||
| + | * Redirect after payment: Enabled | ||
| + | * Partial Grants: 0 | ||
| + | * Retry billing period: 720 | ||
| − | * | + | You will also need to set up the postback url and return url in Itelebill with the following format: |
| − | * | + | *Postback url: http://<linkdomain>/signup/process_itelebill.php |
| + | *Return url: http://<linkdomain>/signup/returnurl_itelebill.php | ||
| − | + | Where <linkdomain> is the [[Link_Domain|linkdomain]] of your site. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
== Setting up Itelebill in NATS == | == Setting up Itelebill in NATS == | ||
| + | Once you have set up Itelebill on their website, you can then proceed to set up Itelebill in your [[NATS]] install. | ||
| + | === Billers Admin === | ||
| + | To begin configuring Itelebill in [[NATS]], go to the [[NATS4 Billers Admin]], select Itelebill from the "Setup New Biller" drop-down menu, and click Add. You will then be prompted for your Itelebill information. | ||
| − | + | Enter the Customer Number that was provided when you signed up for Itelebill, and enter your Variable Pricing Password if you wish to support rebills with Itelebill. | |
| − | |||
| − | |||
| − | |||
=== Sites Admin === | === Sites Admin === | ||
| − | + | In order to use Itelebill to process transactions in [[NATS]], you will need to create a special join option. You can do so by going to the [[NATS4 Sites Admin]] and clicking the "Set Special Payment Options" action icon next to the corresponding site you wish to use Itelebill with. | |
| − | the "Set Special | ||
| − | * Payment Zone ID - | + | You will then be prompted to select your biller (Itelebill), whether you want this option active for all tours on that site, and the Join Form Text that will be displayed to [[Ct#Surfer|surfers]]. |
| − | * Currency type - | + | |
| − | * Initial period - | + | After selecting "Itelebill", a set of biller-specific settings will appear. These settings are: |
| − | * Initial price - | + | |
| − | * Rebill period (optional) - | + | * Payment Zone ID - The ID for this option in the Itelebill admin |
| − | * Rebill price (optional) - | + | * Currency type - The currency that the surfer should be billed in |
| + | * Initial period - Length of the initial join option | ||
| + | * Initial price - The amount the surfer should be in billed in the chosen currency | ||
| + | * Rebill period (optional) - The length of the recurring membership (required for rebilling) | ||
| + | * Rebill price (optional) - The price of the recurring membership (required for rebilling) | ||
* System - Premium rate or SMS. Determines what method you want the surfer to pay in | * System - Premium rate or SMS. Determines what method you want the surfer to pay in | ||
| − | * Iframe mode (optional) - | + | * Iframe mode (optional) - When this option is checked, you can embed the payment system into your website without the surfer having to leave the page |
| + | |||
| + | If you have any further questions regarding Itelebill and [[NATS4]], please [http://clients.toomuchmedia.com put in a support ticket]. | ||
| + | |||
| + | == Troubleshooting == | ||
| + | |||
| + | === SMS Billing === | ||
| + | |||
| + | If you are having issues setting up SMS billing with Itelebill, you may have to set the get variables in your ''<nowiki>http://<linkdomain>/signup/process_itelebill.php</nowiki>'' script. | ||
| + | |||
| + | The correct arguments to pass to this URL are: | ||
| + | |||
| + | ''Grant'': <code><nowiki>http://<linkdomain>/signup/process_itelebill.php?pay_method={METHOD}&transid={TRANSID}&amount={PROFIT}&cur={CURRENCY}&type=grant</nowiki></code><br> | ||
| + | ''Revoke'': <code><nowiki>http://<linkdomain>/signup/process_itelebill.php?type=revoke</nowiki></code><br> | ||
| + | ''Rebill'': <code><nowiki>http://<linkdomain>/signup/process_itelebill.php?pay_method={METHOD}&transid={TRANSID}&amount={PROFIT}&cur={CURRENCY}&type=rebill</nowiki></code><br> | ||
| + | |||
| + | Simply replace <linkdomain> in the above example with your desired [[Ct#Site|site]]'s [[Link Domain|link domain]]. These URLs should pass through the necessary get variables in order for your [[Ct#Member|members]] to process SMS billing transactions. | ||
| + | |||
| + | == Notes == | ||
| + | |||
| + | The following Notes provide further information about this biller: | ||
| + | |||
| + | === Unsubscribe === | ||
| + | |||
| + | If a member unsubscribes from the Itelebill service by contacting them directly, Itelebill will send a notification to Nats: | ||
| + | |||
| + | <pre> | ||
| + | http://<linkdomain>/signup/process_itelebill.php?pay_method={METHOD}&transid={TRANSID}&amount={PROFIT}&cur={CURRENCY}&type=unsubscribe | ||
| + | </pre> | ||
| + | The URL's &type=unsubscribe tail is to cancel the rebill for the member, and will '''NOT''' expire the member. The member should retain access until the expire date in the Members Admin. NATS does not contain handling for type=unsubscribe because if Itelebill doesn't send a post for the rebill, the member will expire on the expire date. | ||
| − | + | [[Category:NATS4 Biller Instructions]] | |
Latest revision as of 13:06, 20 February 2020
NATS 4
|
|---|
Setting up with Itelebill (ITELEBILL)
Before you can set up Itelebill in NATS4, you must first create an account through them. You can do so by going to their website at www.itelebill.com. After your account has been created, you will be able to log in and create a new standard payment zone by using the form provided at the bottom.
In the Payment Zone Editor, you should configure the available values as follows:
- Payment Zone Type: Standard Product Payment
- Web Address: The URL to your website, eg: www.example.org
- Name of Website: The name of your website, eg: Example Website
- Access Period: If you want to use PRS, this will determine the length of subscription, eg: 28 days.
- Access Period Extra Free: None
- Access Period Type: Either 'After Payment Only', or 'While Connected Only'
- Early SMS Grant: Do not send early grant
- Early SMS Revoke: Do not send early revoke
- Testing Mode: Do not allow simulated payments
- Local Currency Conversion: Disabled
- Local Time Conversion: Universal Coordinated Time
- PRS Payment: Enabled if you want PRS telephone call payment, otherwise disabled
- PRS Minutes: The required number of minutes the user must stay on the telephone to complete the transaction
- SMS Payment: Whether you would like to take payment by SMS
- SMS Rebilling: Enabled. This can be configured by the NATS control panel
- Authentication System: I have my own authentication system
- Redirect after payment: Enabled
- Partial Grants: 0
- Retry billing period: 720
You will also need to set up the postback url and return url in Itelebill with the following format:
- Postback url: http://<linkdomain>/signup/process_itelebill.php
- Return url: http://<linkdomain>/signup/returnurl_itelebill.php
Where <linkdomain> is the linkdomain of your site.
Setting up Itelebill in NATS
Once you have set up Itelebill on their website, you can then proceed to set up Itelebill in your NATS install.
Billers Admin
To begin configuring Itelebill in NATS, go to the NATS4 Billers Admin, select Itelebill from the "Setup New Biller" drop-down menu, and click Add. You will then be prompted for your Itelebill information.
Enter the Customer Number that was provided when you signed up for Itelebill, and enter your Variable Pricing Password if you wish to support rebills with Itelebill.
Sites Admin
In order to use Itelebill to process transactions in NATS, you will need to create a special join option. You can do so by going to the NATS4 Sites Admin and clicking the "Set Special Payment Options" action icon next to the corresponding site you wish to use Itelebill with.
You will then be prompted to select your biller (Itelebill), whether you want this option active for all tours on that site, and the Join Form Text that will be displayed to surfers.
After selecting "Itelebill", a set of biller-specific settings will appear. These settings are:
- Payment Zone ID - The ID for this option in the Itelebill admin
- Currency type - The currency that the surfer should be billed in
- Initial period - Length of the initial join option
- Initial price - The amount the surfer should be in billed in the chosen currency
- Rebill period (optional) - The length of the recurring membership (required for rebilling)
- Rebill price (optional) - The price of the recurring membership (required for rebilling)
- System - Premium rate or SMS. Determines what method you want the surfer to pay in
- Iframe mode (optional) - When this option is checked, you can embed the payment system into your website without the surfer having to leave the page
If you have any further questions regarding Itelebill and NATS4, please put in a support ticket.
Troubleshooting
SMS Billing
If you are having issues setting up SMS billing with Itelebill, you may have to set the get variables in your http://<linkdomain>/signup/process_itelebill.php script.
The correct arguments to pass to this URL are:
Grant: http://<linkdomain>/signup/process_itelebill.php?pay_method={METHOD}&transid={TRANSID}&amount={PROFIT}&cur={CURRENCY}&type=grant
Revoke: http://<linkdomain>/signup/process_itelebill.php?type=revoke
Rebill: http://<linkdomain>/signup/process_itelebill.php?pay_method={METHOD}&transid={TRANSID}&amount={PROFIT}&cur={CURRENCY}&type=rebill
Simply replace <linkdomain> in the above example with your desired site's link domain. These URLs should pass through the necessary get variables in order for your members to process SMS billing transactions.
Notes
The following Notes provide further information about this biller:
Unsubscribe
If a member unsubscribes from the Itelebill service by contacting them directly, Itelebill will send a notification to Nats:
http://<linkdomain>/signup/process_itelebill.php?pay_method={METHOD}&transid={TRANSID}&amount={PROFIT}&cur={CURRENCY}&type=unsubscribe
The URL's &type=unsubscribe tail is to cancel the rebill for the member, and will NOT expire the member. The member should retain access until the expire date in the Members Admin. NATS does not contain handling for type=unsubscribe because if Itelebill doesn't send a post for the rebill, the member will expire on the expire date.
