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

C++
#include <CkHttp.h>
#include <CkDateTime.h>
#include <CkJsonObject.h>
#include <CkHttpResponse.h>

void ChilkatSample(void)
    {
    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    CkHttp http;
    http.put_RequireSslCertVerify(true);

    http.SetRequestHeader("Authorization","CHAT_2_PAY_API_KEY");
    http.SetRequestHeader("Accept","application/json");
    CkDateTime now;
    now.SetFromCurrentSystemTime();
    const char *orderNumber = "ORD-1042";
    CkJsonObject body;
    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");
    CkHttpResponse resp;
    bool sent = http.HttpJson("POST","https://chat2pay-service.clickatell.com/api/v2/chat-2-pay",body,"application/json",resp);
    if (resp.get_StatusCode() == 0) {
        std::cout << "No HTTP response. Check this order in Chat 2 Pay before retrying." << "\r\n";
        return;
    }

    CkJsonObject reply;
    bool parsed = reply.Load(resp.bodyStr());
    if ((sent != true) || (resp.get_StatusCode() != 201)) {
        std::cout << "Payment-link request returned HTTP " << resp.get_StatusCode() << "\r\n";
        if (reply.HasMember("message") == true) {
            std::cout << reply.stringOf("message") << "\r\n";
        }

        return;
    }

    const char *reference = reply.stringOf("paymentLinkRef");
    if ((parsed != true) || (reply.JsonTypeOf("paymentLinkRef") != 1) || (reference == "")) {
        std::cout << "Missing payment link reference. Check the transaction before retrying." << "\r\n";
        return;
    }

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

    bool saved = record.WriteFile("order-1042-payment-link.json");
    if (saved != true) {
        std::cout << "Link already created. Save this reference with the order: " << reference << "\r\n";
        return;
    }

    std::cout << "Saved the payment link reference for " << orderNumber << "\r\n";
    }