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

Unicode C
#include <C_CkHttpW.h>
#include <C_CkDateTimeW.h>
#include <C_CkJsonObjectW.h>
#include <C_CkHttpResponseW.h>

void ChilkatSample(void)
    {
    HCkHttpW http;
    HCkDateTimeW now;
    const wchar_t *orderNumber;
    HCkJsonObjectW body;
    HCkHttpResponseW resp;
    BOOL sent;
    HCkJsonObjectW reply;
    BOOL parsed;
    const wchar_t *reference;
    HCkJsonObjectW record;
    BOOL saved;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    http = CkHttpW_Create();
    CkHttpW_putRequireSslCertVerify(http,TRUE);

    CkHttpW_SetRequestHeader(http,L"Authorization",L"CHAT_2_PAY_API_KEY");
    CkHttpW_SetRequestHeader(http,L"Accept",L"application/json");
    now = CkDateTimeW_Create();
    CkDateTimeW_SetFromCurrentSystemTime(now);
    orderNumber = L"ORD-1042";
    body = CkJsonObjectW_Create();
    CkJsonObjectW_UpdateString(body,L"applicationId",L"CHAT_2_PAY_APPLICATION_ID");
    CkJsonObjectW_UpdateString(body,L"channel",L"sms");
    CkJsonObjectW_UpdateString(body,L"to",L"PHONE_NUMBER");
    CkJsonObjectW_UpdateString(body,L"orderNumber",orderNumber);
    CkJsonObjectW_UpdateString(body,L"timestamp",CkDateTimeW_getAsTimestamp(now,FALSE));
    CkJsonObjectW_UpdateString(body,L"currency",L"USD");
    CkJsonObjectW_UpdateNumber(body,L"totalAmount",L"49.95");
    resp = CkHttpResponseW_Create();
    sent = CkHttpW_HttpJson(http,L"POST",L"https://chat2pay-service.clickatell.com/api/v2/chat-2-pay",body,L"application/json",resp);
    if (CkHttpResponseW_getStatusCode(resp) == 0) {
        wprintf(L"No HTTP response. Check this order in Chat 2 Pay before retrying.\n");
        CkHttpW_Dispose(http);
        CkDateTimeW_Dispose(now);
        CkJsonObjectW_Dispose(body);
        CkHttpResponseW_Dispose(resp);
        return;
    }

    reply = CkJsonObjectW_Create();
    parsed = CkJsonObjectW_Load(reply,CkHttpResponseW_bodyStr(resp));
    if ((sent != TRUE) || (CkHttpResponseW_getStatusCode(resp) != 201)) {
        wprintf(L"Payment-link request returned HTTP %d\n",CkHttpResponseW_getStatusCode(resp));
        if (CkJsonObjectW_HasMember(reply,L"message") == TRUE) {
            wprintf(L"%s\n",CkJsonObjectW_stringOf(reply,L"message"));
        }

        CkHttpW_Dispose(http);
        CkDateTimeW_Dispose(now);
        CkJsonObjectW_Dispose(body);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    reference = CkJsonObjectW_stringOf(reply,L"paymentLinkRef");
    if ((parsed != TRUE) || (CkJsonObjectW_JsonTypeOf(reply,L"paymentLinkRef") != 1) || (reference == L"")) {
        wprintf(L"Missing payment link reference. Check the transaction before retrying.\n");
        CkHttpW_Dispose(http);
        CkDateTimeW_Dispose(now);
        CkJsonObjectW_Dispose(body);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    record = CkJsonObjectW_Create();
    CkJsonObjectW_UpdateString(record,L"orderNumber",orderNumber);
    CkJsonObjectW_UpdateString(record,L"paymentLinkRef",reference);
    if (CkJsonObjectW_JsonTypeOf(reply,L"transactionStatus") == 1) {
        CkJsonObjectW_UpdateString(record,L"transactionStatus",CkJsonObjectW_stringOf(reply,L"transactionStatus"));
    }

    saved = CkJsonObjectW_WriteFile(record,L"order-1042-payment-link.json");
    if (saved != TRUE) {
        wprintf(L"Link already created. Save this reference with the order: %s\n",reference);
        CkHttpW_Dispose(http);
        CkDateTimeW_Dispose(now);
        CkJsonObjectW_Dispose(body);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkJsonObjectW_Dispose(record);
        return;
    }

    wprintf(L"Saved the payment link reference for %s\n",orderNumber);


    CkHttpW_Dispose(http);
    CkDateTimeW_Dispose(now);
    CkJsonObjectW_Dispose(body);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(reply);
    CkJsonObjectW_Dispose(record);

    }