Process an ApplePay transaction.

Changed on
post/gateway/remote.json

Request

  • Base URL
    https://secure.telr.com
  • URL
    https://secure.telr.com/gateway/remote.json
  • Auth
    none declared

Request body

storeinteger required

Your store ID.

authkeystring required

Your authentication key.

Example request

{
  "store": 12345,
  "tran": {
    "id": "1236100014",
    "class": "ecom",
    "type": "sale",
    "description": "ApplePay transaction",
    "amount": 1,
    "currency": "AED",
    "method": "applepay"
  },
  "applepay": {
    "token": {
      "paymentData": {
        "header": {
          "transactionId": "xxxxxxxx",
          "ephemeralPublicKey": "xxxxxxxx"
        },
        "version": "EC_v1"
      },
      "paymentMethod": {
        "network": "MasterCard 1234",
        "type": "MasterCard"
      }
    }
  },
  "customer": {
    "name": {
      "forenames": "Test",
      "surname": "User"
    },
    "email": "test@gmail.com",
    "address": {
      "line1": "Address",
      "country": "AE",
      "city": "Dubai"
    },
    "phone": "0123456789"
  }
}

Response

Response

OR

Example response

{
  "trace": "4001/5151/%ea6bba9",
  "transaction": {
    "ref": "040024871559",
    "type": "sale",
    "class": "ECom",
    "status": "D",
    "code": "31",
    "message": "Not authorised"
  },
  "customer": {
    "email": "abcfd@gmail.com",
    "name": {
      "forenames": "A bcd",
      "surname": "sff"
    },
    "address": {
      "line1": "No address",
      "city": "Unknown",
      "country": "AE"
    }
  }
}

Changes

    • breaking

      added the new required request property

    • breaking

      removed subschema #1: GooglePayTokens subschema #2: NetworkToken from the request body oneOf list

    • breaking

      the request property became required

    • breaking

      removed the enum value googlepay of the request property /

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • info

      added the new applepay enum value to the request property /

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status