Sample code for 30+ languages & platforms
JavaScript 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

Note
This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.
JavaScript
//  Assumes Chilkat is unlocked. See Global Unlock Sample.
var http = new CkHttp();
http.RequireSslCertVerify = true;

http.SetRequestHeader("Authorization","CHAT_2_PAY_API_KEY");
http.SetRequestHeader("Accept","application/json");
var now = new CkDateTime();
now.SetFromCurrentSystemTime();
var orderNumber = "ORD-1042";
var 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");
var resp = new CkHttpResponse();
var sent = http.HttpJson("POST","https://chat2pay-service.clickatell.com/api/v2/chat-2-pay",body,"application/json",resp);
if (resp.StatusCode == 0) {
    console.log("No HTTP response. Check this order in Chat 2 Pay before retrying.");
    return;
}

var reply = new CkJsonObject();
var parsed = reply.Load(resp.BodyStr);
if ((sent !== true) || (resp.StatusCode !== 201)) {
    console.log("Payment-link request returned HTTP " + resp.StatusCode);
    if (reply.HasMember("message") == true) {
        console.log(reply.StringOf("message"));
    }

    return;
}

var reference = reply.StringOf("paymentLinkRef");
if ((parsed !== true) || (reply.JsonTypeOf("paymentLinkRef") !== 1) || (reference == "")) {
    console.log("Missing payment link reference. Check the transaction before retrying.");
    return;
}

var record = new CkJsonObject();
record.UpdateString("orderNumber",orderNumber);
record.UpdateString("paymentLinkRef",reference);
if (reply.JsonTypeOf("transactionStatus") == 1) {
    record.UpdateString("transactionStatus",reply.StringOf("transactionStatus"));
}

var saved = record.WriteFile("order-1042-payment-link.json");
if (saved !== true) {
    console.log("Link already created. Save this reference with the order: " + reference);
    return;
}

console.log("Saved the payment link reference for " + orderNumber);