SMS development
API Documenatatie
Normal SMS Gateway
PHP implementatie met de SMS Client
beschikbaar gemaakt, deze is te vinden op:
- GitHub: https://github.com/TeleConcept-nl/sms-client
- Packagist voor Composer: https://packagist.org/packages/teleconcept/sms-client
<?php
//Start creation
$client = new \Teleconcept\Sms\Client\Client('https://sms-api.teleconcept.nl');
$request = new \Teleconcept\Sms\Client\Request\Message\CreateRequest($client);
$request
->setAuthorization('40924ec10f3aaed662fe62aac', 154135)
->setRequiredParameters('This is a message', 'Sender name', ['0612345678'])
->setAuthorization('40924ec10f3aaed662fe62aac', 154135);
$response = $request->send();
$messages = $response->messages();
$message = $messages[0];
echo $message->reference(); // string uuidv4
echo $message->status(); // current status of the message
echo $message->originator(); // sender name
echo $message->recipient(); // recipient telephone number
echo $message->encoding(); // encoding
echo $message->body(); // the message
echo $message->scheduledAt(); // when will it be sent
echo $message->texts(); // number of credits used to send this message
<?php
$client = new \Teleconcept\Sms\Client\Client('https://sms-api.teleconcept.nl');
$request = new \Teleconcept\Sms\Client\Request\Message\CheckRequest($client);
$response = $request
->setAuthorization('40924ec10f3aaed662fe62aac', 154135)
->setReference('b5638234-8623-42d0-8c8a-b91a50191788')
->send();
$message = $response->message();
echo $message->reference(); // string uuidv4
echo $message->status(); // current status of the message
echo $message->originator(); // sender name
echo $message->recipient(); // recipient telephone number
echo $message->encoding(); // encoding
echo $message->body(); // the message
echo $message->scheduledAt(); // when will it be sent
<?php
$client = new \Teleconcept\Sms\Client\Client('https://sms-api.teleconcept.nl');
$request = new \Teleconcept\Sms\Client\Request\Credit\CheckRequest($client);
$response = $request
->setAuthorization('40924ec10f3aaed662fe62aac', 154135)
->send();
echo $response->total(); //All the credits you ever bought
echo $response->available(); //All the unspent credits you have left
$purchases = $response->purchases();
$purchase = $purchases[0];
echo $purchase->reference(); // reference of the purchase
echo $purchase->total(); // number of credits purchased
echo $purchase->available(); // number of unspent credits left
echo $purchase->createdAt(); // date and time of purchase
Zelfbouw implementatie met de API
Premium SMS Betalen
Op deze pagina staat beschreven hoe u een Premium SMS betaling afhandelt via Teleconcept door gebruik te maken van onze API (technische koppeling). Om hiermee aan de slag te kunnen heeft u technische kennis nodig.
1. Werking van de API in een notedop
Afrekenen met de SMS Pincode variant werkt als volgt:
- U vraagt aan uw bezoeker een bepaald keyword per SMS te sturen naar de shortcode van Teleconcept (zie punt 2).Elk keyword vertegenwoordigt een vaste prijs. Voor een overzicht met alle beschikbare keywords/shortcodes en de bijbehorende prijzen kijkt u bij het tabblad SMS Betaal Keywords;
- Uw bezoeker ontvangt per SMS een pincode;
- Uw bezoeker vult de pincode in op uw site, de geldigheid van deze pincode kunt u verifiëren bij Teleconcept;
- Bij een succesvolle betaling kunt u de gekozen dienst leveren aan uw bezoeker.
2. Voorbeeld betaalscherm
U toont de bezoeker een betaalscherm met de volgende informatie:
- Keyword (Bijv. BETAAL AA);
- Shortcode, het 4-cijferige nummer waar de sms naartoe gestuurd moet worden (Bijv. 3010);
- Valuta en bedrag;
Naast deze informatie vraagt u de bezoeker om de ontvangen pincode in te voeren op uw website en dan op de knop ‘verder’ te klikken.
Voorbeeld
3. API om pincode te controleren
Klik op deze link voor de API welke u kunt gebruiken om een ingevoerde pincode te controleren.
SMS Betaal Keywords
|
API-Key
Voor diverse diensten heeft u een API-Key nodig. Een API-Key is een beveiligde sleutel die u nodig heeft als u één van de diensten van TeleConcept wilt integreren in uw eigen systeem. Deze API-Key is voor alle diensten binnen Teleconcept hetzelfde en kunt u vinden in uw account.