TargetSMS > Pay > SMS Access Subscription > Documentation
Login Digiwallet English  Nederlands
About us   Jobs Contact Home
TargetSMS
• Product overview
• Payout rates
• F.A.Q.
• News
• Local regulation
• Service messages
Fun & infotainment
• SMS Subscription
• SMS Info
• SMS Mobile
• SMS Poll-Vote
• SMS & Win
SMS Contact
• SMS-2-Mail
• SMS-2-Web
• SMS Callme
Micropayments
• SMS Donate
• SMS Site access
Gateway
• Premium SMS
• Normal SMS
Not logged in...
• Login



  
Info Payout_rates Documentation Wizard Maintenance

SMS Access Subscription

1. General
The documentation of Advanced SMS Subscription has been subdivided in subscribe, membership and unsubscribe a subscriber. You will find these below.


2. Subscribe
The subscription procedure:
  1. Your customer subscribes by sending KEYWORD ON to the shortcode.
  2. TargetSMS tells your system there is a new subscription.
  3. Your system sends the customer a message with a question to confirm the subscription by sending KEYWORD OK to the shortcode.
  4. Your customer sends the confirmation asked for to the shortcode.
  5. TargetSMS tells your system the new subscription has been confirmed.
  6. The visitor receives an answer with a pincode to confirm the successful application from TargetMedia. This message has a fixed tariff of 25 eurocents.
  7. The visitor fills in the pincode on your site (see point 5).
  8. You check with us if the payment was successful (see point 6).
  9. After a successful payment you can deliver the chosen service(s) to your new subscriber.



3. During membership
As soon as you create an access subscription service, we will regularly send messages to your subscribers to collect the contribution for your service. You can choose the frequency when you create the service. First they will receive the welcoming message, followed by the so called repeat messages.


4. Unsubscribe
Unsubscribing from a service can be done in 2 ways.

The customer unsubscribes himself/herself.
  1. Your customer unsubscribes by sending KEYWORD OFF to the shortcode.
  2. TargetSMS tells your system that a subscription has been cancelled.
  3. Targetmedia sends a message to the customer to confirm the successful unsubscription.
You will find information on receiving messages on your system in the document: documentation MO messages


Unsubscribing automatically after x times not paying.
  1. If you have chosen to fill in the field auto-unsubscribe while creating your service, we also check if a subscriber has paid and if he or she has exceeded the number of no payments, he/she is unsubscribed automatically. You receive an e-mail when this happens.

5. Show payment screen to visitor

You show the visitor a payment screen with the following information:
  • Keyword (e.g. PINCODE);
  • Shortcode, the 4 digit number, the SMS must be sent to (e.g. 3010);
  • Valuta and price;
In addition to this information you ask the visitor to enter the received pincode on your website and click the 'continue' button.

Example

SMS PINCODE to 3010 (€ 2,85).

You receive an SMS with a pincode. Enter the pincode below and press the 'continue' button.






6. Check pincode
Call the following URL by using HTTP POST to check the pincode:

http://api.targetpay.nl/payment/checksmspincode.asp

Use the next parameters:

Variable Name Format Required
rtlo layoutcode numerical yes
keyword used keyword alphanumeric yes
code by user entered pincode numerical yes
shortcode 4 digit shortcode numerical yes
co country code numerical yes
test test mode numerical no

Explanation by variable:

7. Result codes
When the pincode is right, the following will be sent back:

000 OK

If something is wrong, one of the following error codes will be returned:

001 no layoutcode specified
002 no pincode specified
003 pincode format is incorrect (must be 6 digits)
004 pincode already checked at [date and time]
005 pincode not found
006 test format is incorrect (must be 0 or 1)
007 no shortkey specified
008 no shortcode specified
009 no country specified
010 invalid countrycode
011 invalid shortcode
012 shortcode format is incorrect (must be 4 digits)


8. Remarks
  • The most expensive SMS will be sent last. E.g. to collect € 2.85 the order is 1x € 0.25 then 1x € 1.10 and finally 1x € 1.50.

  • You can process several pincodes in a script at the same time, and collect multiple rates this way. You process a call per pincode as described above.

  • Pincodes are valid for 24 hours.

    • It is important that you stick to the rules which apply to SMS services at any time. TargetSMS reserves the right to deduct from your payment, any costs resulting from possible damage to the SMS Gateway as a result of improper use (e.g. in the form of fines). See the appropriate legislation in the country concerned:
  • Legislation SMS the Netherlands
  • Legislation SMS Belgium
    		•

    Algemene Voorwaarden | Cookie Policy | Cookie Instellingen | Privacy Statement