General

Lesaka Online - General Integration#

This is general documentation that includes products that can be used with Virtual hosted pages, Enterprise integration or the SDK.

Webhook Setup#

  1. Please contact us at support@adumoonline.com in order to enable and setup webhooks for your application.
  2. You need to expose an endpoint in your system and send us the url in order for us to configure your webhook.
  3. Lesaka Online will send the results of each transaction to this endpoint up to a maximum of 3 times.
  4. Once our system receives a 200 OK message we will stop sending the webhook.
  5. Your system will need to interpret the below JSON payload, once received your system should return a 200 OK message.
  6. The JSON payload will be sent via a HTTP POST, so your endpoint needs to accept a POST.

JSON Payload Example#

{
  "timestamp": "1638369221525",
  "transactionId": "9b783a27-282c-40f0-91a5-ce55a244b8f0",
  "merchantReference": "JWT-Webhook-T06",
  "originatingTransactionId": "b2df6f4f-0828-4df3-8d2e-3c8e4e5aa395",
  "status": "SETTLED",
  "paymentMethod": "CARD",
  "amount": 1,
  "message": null,
  "possibleFraudulentTransaction": false,
  "version": null,
  "token": "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJbQkA1ZjFkZTMyZCIsImlhdCI6MTYzODM2OTIyMiwidHJhbnNhY3Rpb25pbmRleCI6IjliNzgzYTI3LTI4MmMtNDBmMC05MWE1LWNlNTVhMjQ0YjhmMCIsIm1yZWYiOiJKV1QtV2ViaG9vay1UMDYiLCJzdGF0dXMiOiJTRVRUTEVEIiwiYW1vdW50IjoiMS4wIn0.OQRweYyMXv8SxvfUKkGysAx0KW45WbsfY-3HA5rRiNM"
}

Field Reference#

  • Data Element Name: timestamp
    • Field Type: string
    • Format: date-time
    • Example: 1638369221525
  • Data Element Name: transactionId
    • Field Type: string
    • Format: GUID
    • Example: 9b783a27-282c-40f0-91a5-ce55a244b8f0
  • Data Element Name: merchantReference
    • Field Type: string
    • Format: 255
    • Example: JWT-Webhook-T06
  • Data Element Name: originatingTransactionId
    • Field Type: string
    • Format: GUID
    • Example: b2df6f4f-0828-4df3-8d2e-3c8e4e5aa395
  • Data Element Name: status
    • Field Type: string
    • Format: 255
    • Example: “AUTHORIZED”, - Success “SETTLED”, - Success “FAILED”, - Failure “DECLINED”, - Bank Declined “TDS_AUTH_FAILED”, - 3DS Failed “TIME_OUT” - 3DS Not completed
  • Data Element Name: paymentMethod
    • Field Type: string
    • Format: 255
    • Example: CARD
  • Data Element Name: amount
    • Field Type: number
    • Format: float
    • Example: 1.00
  • Data Element Name: message
    • Field Type: string
    • Format: 255
    • Example: Insufficient Funds
  • Data Element Name: possibleFraudulentTransaction
    • Field Type: boolean
    • Format:
    • Example: false
  • Data Element Name: version
    • Field Type: string
    • Format: 255
    • Example: null
  • Data Element Name: token
    • Field Type: string
    • Format: 255
    • Example: eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJbQkA1ZjFkZTMyZCIsImlhdC I6MTYzODM2OTIyMiwidHJhbnNhY3Rpb25pbmRleCI6IjliNzgzY TI3LTI4MmMtNDBmMC05MWE1LWNlNTVhMjQ0YjhmMCIsIm1yZWY iOiJKV1QtV2ViaG9vay1UMDYiLCJzdGF0dXMiOiJTRV RUTEVEIiwiYW1vdW50IjoiMS4wIn0.OQRweYyMXv8SxvfU KkGysAx0KW45WbsfY-3HA5rRiNM

For many years, MyGate has been one of the leading payment service providers in South Africa offering you technology and products to suit your online business needs. In 2017, MyGate was acquired by Lesaka Online, a global leader in digital payments solutions. This helped solidify our market leader status.

We are excited to announce that from 28 May 2019 MyGate will be rebranded as Lesaka Online, presenting a unified brand throughout the world.

What does this rebranding mean?

This rebranding provides you with:

  • Access to even more Omni-channel technologies (online, in-store, mobile)
  • The tools to engage in truly borderless commerce with a world of opportunities to grow your business

Who can I contact if I have questions?
If you have any questions about the brand name change, we would be happy to answer them by email at support@adumoonline.com or by telephone on 021 555 3260.

The Lesaka Online Team

Find out more about our products

SDK Integration#

For a drop-in JavaScript client that renders payment UI components directly on your page, see the SDK Integration Guide . Full configuration schemas, appearance customization and live examples are available in the SDK Resources .