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

Xbase++
LOCAL oHttp
LOCAL oNow
LOCAL cOrderNumber
LOCAL oBody
LOCAL oResp
LOCAL nSent
LOCAL oReply
LOCAL nParsed
LOCAL cReference
LOCAL oRecord
LOCAL nSaved

//  Assumes Chilkat is unlocked. See Global Unlock Sample.
oHttp := CreateObject("Chilkat.Http")
oHttp:RequireSslCertVerify := 1

oHttp:SetRequestHeader("Authorization", "CHAT_2_PAY_API_KEY")
oHttp:SetRequestHeader("Accept", "application/json")
oNow := CreateObject("Chilkat.CkDateTime")
oNow:SetFromCurrentSystemTime()
cOrderNumber := "ORD-1042"
oBody := CreateObject("Chilkat.JsonObject")
oBody:UpdateString("applicationId", "CHAT_2_PAY_APPLICATION_ID")
oBody:UpdateString("channel", "sms")
oBody:UpdateString("to", "PHONE_NUMBER")
oBody:UpdateString("orderNumber", cOrderNumber)
oBody:UpdateString("timestamp", oNow:GetAsTimestamp(0))
oBody:UpdateString("currency", "USD")
oBody:UpdateNumber("totalAmount", "49.95")
oResp := CreateObject("Chilkat.HttpResponse")
nSent := oHttp:HttpJson("POST", "https://chat2pay-service.clickatell.com/api/v2/chat-2-pay", oBody, "application/json", oResp)
IF (oResp:StatusCode == 0)
    ? "No HTTP response. Check this order in Chat 2 Pay before retrying."
    oHttp:destroy()
    oNow:destroy()
    oBody:destroy()
    oResp:destroy()
    RETURN
ENDIF

oReply := CreateObject("Chilkat.JsonObject")
nParsed := oReply:Load(oResp:BodyStr)
IF ((nSent != 1) .OR. (oResp:StatusCode != 201))
    ? "Payment-link request returned HTTP " + Str(oResp:StatusCode)
    IF (oReply:HasMember("message") == 1)
        ? oReply:StringOf("message")
    ENDIF

    oHttp:destroy()
    oNow:destroy()
    oBody:destroy()
    oResp:destroy()
    oReply:destroy()
    RETURN
ENDIF

cReference := oReply:StringOf("paymentLinkRef")
IF ((nParsed != 1) .OR. (oReply:JsonTypeOf("paymentLinkRef") != 1) .OR. (cReference == ""))
    ? "Missing payment link reference. Check the transaction before retrying."
    oHttp:destroy()
    oNow:destroy()
    oBody:destroy()
    oResp:destroy()
    oReply:destroy()
    RETURN
ENDIF

oRecord := CreateObject("Chilkat.JsonObject")
oRecord:UpdateString("orderNumber", cOrderNumber)
oRecord:UpdateString("paymentLinkRef", cReference)
IF (oReply:JsonTypeOf("transactionStatus") == 1)
    oRecord:UpdateString("transactionStatus", oReply:StringOf("transactionStatus"))
ENDIF

nSaved := oRecord:WriteFile("order-1042-payment-link.json")
IF (nSaved != 1)
    ? "Link already created. Save this reference with the order: " + cReference
    oHttp:destroy()
    oNow:destroy()
    oBody:destroy()
    oResp:destroy()
    oReply:destroy()
    oRecord:destroy()
    RETURN
ENDIF

? "Saved the payment link reference for " + cOrderNumber

oHttp:destroy()
oNow:destroy()
oBody:destroy()
oResp:destroy()
oReply:destroy()
oRecord:destroy()