Sample code for 30+ languages & platforms
CkPhp Requires Chilkat v11.0.0+

Clickatell Chat 2 Pay: Send a payment link for an order

See more Clickatell Examples

Use a configured Chat 2 Pay application and its own API key. Supply the application ID, an unpaid order, and a recipient on the configured SMS channel. Clickatell creates and sends the checkout link. HTTP 201 returns a paymentLinkRef that can be saved on the order. Keep the order unpaid pending confirmation of payment.

The example writes a local reference record for the sample order. After an uncertain network result, check the transaction in Clickatell before creating another link.

Clickatell API reference

Chilkat CkPhp Downloads

CkPhp
<?php

include("chilkat.php");

//  Assumes Chilkat is unlocked. See Global Unlock Sample.
$http = new CkHttp();
$http->put_RequireSslCertVerify(true);

$http->SetRequestHeader('Authorization','CHAT_2_PAY_API_KEY');
$http->SetRequestHeader('Accept','application/json');
$now = new CkDateTime();
$now->SetFromCurrentSystemTime();
$orderNumber = 'ORD-1042';
$body = new CkJsonObject();
$body->UpdateString('applicationId','CHAT_2_PAY_APPLICATION_ID');
$body->UpdateString('channel','sms');
$body->UpdateString('to','PHONE_NUMBER');
$body->UpdateString('orderNumber',$orderNumber);
$body->UpdateString('timestamp',$now->getAsTimestamp(false));
$body->UpdateString('currency','USD');
$body->UpdateNumber('totalAmount','49.95');
$resp = new CkHttpResponse();
$sent = $http->HttpJson('POST','https://chat2pay-service.clickatell.com/api/v2/chat-2-pay',$body,'application/json',$resp);
if ($resp->get_StatusCode() == 0) {
    print 'No HTTP response. Check this order in Chat 2 Pay before retrying.' . "\n";
    exit;
}

$reply = new CkJsonObject();
$parsed = $reply->Load($resp->bodyStr());
if (($sent != true) or ($resp->get_StatusCode() != 201)) {
    print 'Payment-link request returned HTTP ' . $resp->get_StatusCode() . "\n";
    if ($reply->HasMember('message') == true) {
        print $reply->stringOf('message') . "\n";
    }

    exit;
}

$reference = $reply->stringOf('paymentLinkRef');
if (($parsed != true) or ($reply->JsonTypeOf('paymentLinkRef') != 1) or ($reference == '')) {
    print 'Missing payment link reference. Check the transaction before retrying.' . "\n";
    exit;
}

$record = new CkJsonObject();
$record->UpdateString('orderNumber',$orderNumber);
$record->UpdateString('paymentLinkRef',$reference);
if ($reply->JsonTypeOf('transactionStatus') == 1) {
    $record->UpdateString('transactionStatus',$reply->stringOf('transactionStatus'));
}

$saved = $record->WriteFile('order-1042-payment-link.json');
if ($saved != true) {
    print 'Link already created. Save this reference with the order: ' . $reference . "\n";
    exit;
}

print 'Saved the payment link reference for ' . $orderNumber . "\n";

?>