Touch 'n Go via Checkout.com

​

Supported workflows

​

Before you begin

1. Set up a Checkout.com integration in your workspace. Follow the Checkout.com integration setup guide if you don’t have one yet.
2. Ask Checkout.com to enable Alipay+ and Touch ‘n Go on your Checkout.com processing channel.
3. In the Payrails Portal, go to Settings → Integrations, open your Checkout.com integration, select Touch ‘n Go under Payment methods, and save.
4. Add Touch ‘n Go as a payment option in your workflow.

​

Request fields for Checkout.com

​

Authorize a Touch ‘n Go payment

{
  "amount": {
    "value": "50.00",
    "currency": "MYR"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "touchNGo",
      "amount": {
        "value": "50.00",
        "currency": "MYR"
      }
    }
  ],
  "meta": {
    "customer": {
      "name": "Aisyah",
      "lastName": "Rahman",
      "email": "aisyah.rahman@example.com"
    },
    "order": {
      "description": "Order 1234",
      "lines": [
        {
          "id": "item-1",
          "name": "Phone case",
          "quantity": 1,
          "unitPrice": {
            "value": "50.00",
            "currency": "MYR"
          }
        }
      ]
    },
    "clientContext": {
      "clientType": "app",
      "osType": "android"
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

How Checkout.com handles Touch ‘n Go

• Checkout.com processes Touch ‘n Go through the Alipay+ network. Payrails creates a payment setup at Checkout.com and confirms it for Touch ‘n Go. The confirmation returns the redirect to Touch ‘n Go.
• Touch ‘n Go through Checkout.com is an app-based wallet payment, so every request needs the customer’s mobile operating system in meta.clientContext.osType.
• Payrails sends only order lines of type lineItem, or lines with no type. It skips tax, discount and shipping lines, and lines with no unit price or a zero quantity.
• If Checkout.com reports that Touch ‘n Go isn’t ready on your processing channel, the payment fails before Payrails redirects the customer.