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

PureBasic
IncludeFile "CkHttpResponse.pb"
IncludeFile "CkHttp.pb"
IncludeFile "CkJsonObject.pb"
IncludeFile "CkDateTime.pb"

Procedure ChilkatExample()

    ;  Assumes Chilkat is unlocked. See Global Unlock Sample.
    http.i = CkHttp::ckCreate()
    If http.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkHttp::setCkRequireSslCertVerify(http, 1)

    CkHttp::ckSetRequestHeader(http,"Authorization","CHAT_2_PAY_API_KEY")
    CkHttp::ckSetRequestHeader(http,"Accept","application/json")
    now.i = CkDateTime::ckCreate()
    If now.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkDateTime::ckSetFromCurrentSystemTime(now)
    orderNumber.s = "ORD-1042"
    body.i = CkJsonObject::ckCreate()
    If body.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckUpdateString(body,"applicationId","CHAT_2_PAY_APPLICATION_ID")
    CkJsonObject::ckUpdateString(body,"channel","sms")
    CkJsonObject::ckUpdateString(body,"to","PHONE_NUMBER")
    CkJsonObject::ckUpdateString(body,"orderNumber",orderNumber)
    CkJsonObject::ckUpdateString(body,"timestamp",CkDateTime::ckGetAsTimestamp(now,0))
    CkJsonObject::ckUpdateString(body,"currency","USD")
    CkJsonObject::ckUpdateNumber(body,"totalAmount","49.95")
    resp.i = CkHttpResponse::ckCreate()
    If resp.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    sent.i = CkHttp::ckHttpJson(http,"POST","https://chat2pay-service.clickatell.com/api/v2/chat-2-pay",body,"application/json",resp)
    If CkHttpResponse::ckStatusCode(resp) = 0
        Debug "No HTTP response. Check this order in Chat 2 Pay before retrying."
        CkHttp::ckDispose(http)
        CkDateTime::ckDispose(now)
        CkJsonObject::ckDispose(body)
        CkHttpResponse::ckDispose(resp)
        ProcedureReturn
    EndIf

    reply.i = CkJsonObject::ckCreate()
    If reply.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    parsed.i = CkJsonObject::ckLoad(reply,CkHttpResponse::ckBodyStr(resp))
    If (sent <> 1) OR (CkHttpResponse::ckStatusCode(resp) <> 201)
        Debug "Payment-link request returned HTTP " + Str(CkHttpResponse::ckStatusCode(resp))
        If CkJsonObject::ckHasMember(reply,"message") = 1
            Debug CkJsonObject::ckStringOf(reply,"message")
        EndIf

        CkHttp::ckDispose(http)
        CkDateTime::ckDispose(now)
        CkJsonObject::ckDispose(body)
        CkHttpResponse::ckDispose(resp)
        CkJsonObject::ckDispose(reply)
        ProcedureReturn
    EndIf

    reference.s = CkJsonObject::ckStringOf(reply,"paymentLinkRef")
    If (parsed <> 1) OR (CkJsonObject::ckJsonTypeOf(reply,"paymentLinkRef") <> 1) OR (reference = "")
        Debug "Missing payment link reference. Check the transaction before retrying."
        CkHttp::ckDispose(http)
        CkDateTime::ckDispose(now)
        CkJsonObject::ckDispose(body)
        CkHttpResponse::ckDispose(resp)
        CkJsonObject::ckDispose(reply)
        ProcedureReturn
    EndIf

    record.i = CkJsonObject::ckCreate()
    If record.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckUpdateString(record,"orderNumber",orderNumber)
    CkJsonObject::ckUpdateString(record,"paymentLinkRef",reference)
    If CkJsonObject::ckJsonTypeOf(reply,"transactionStatus") = 1
        CkJsonObject::ckUpdateString(record,"transactionStatus",CkJsonObject::ckStringOf(reply,"transactionStatus"))
    EndIf

    saved.i = CkJsonObject::ckWriteFile(record,"order-1042-payment-link.json")
    If saved <> 1
        Debug "Link already created. Save this reference with the order: " + reference
        CkHttp::ckDispose(http)
        CkDateTime::ckDispose(now)
        CkJsonObject::ckDispose(body)
        CkHttpResponse::ckDispose(resp)
        CkJsonObject::ckDispose(reply)
        CkJsonObject::ckDispose(record)
        ProcedureReturn
    EndIf

    Debug "Saved the payment link reference for " + orderNumber


    CkHttp::ckDispose(http)
    CkDateTime::ckDispose(now)
    CkJsonObject::ckDispose(body)
    CkHttpResponse::ckDispose(resp)
    CkJsonObject::ckDispose(reply)
    CkJsonObject::ckDispose(record)


    ProcedureReturn
EndProcedure