Least-Cost Routing Processing

This section shows you how to apply least-cost routing to an authorization request.

Prerequisite

To enable least-cost routing, contact customer support to have your account configured for this feature.

Fields Specific to this Use Case

Include this field with a standard authorization request when processing a least-cost routing request:
processingInformation.leastCostRouting
Set the value to
true
.

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments

Requirement

To enable least-cost routing, contact customer support to have your account configured for this feature.

Related Information

Required Fields for Requesting Least-Cost Routing in an Authorization

Use these required fields to include least-cost routing in an authorization.
IMPORTANT
When relaxed requirements for address data and the expiration date are being used, not all fields in this list are required. It is your responsibility to determine whether your account is enabled to use this feature and which fields are required. For details about relaxed requirements, see Relaxed Requirements for Address Data and Expiration Date in Payment Transactions.

REST Example: Requesting an Authorization with Least-Cost Routing

Request 
{
  "clientReferenceInformation": {
    "code": "TC50171_3"
  },
  "processingInformation": {
      "leastCostRouting": "true"
  }, 
  "paymentInformation": {
    "card": {
      "number": "4111111111111111",
      "expirationMonth": "12",
      "expirationYear": "2031"
    }
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "102.21",
      "currency": "USD"
    },
    "billTo": {
      "firstName": "John",
      "lastName": "Doe",
      "address1": "1 Market St",
      "locality": "san francisco",
      "administrativeArea": "CA",
      "postalCode": "94105",
      "country": "US",
      "email": "test@cybs.com",
      "phoneNumber": "4158880000"
    }
  }
}
Response to a Successful Request
{
  "_links": {
    "authReversal": {
      "method": "POST",
      "href": "/pts/v2/payments/6843757345116021304951/reversals"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/payments/6843757345116021304951"
    },
    "capture": {
      "method": "POST",
      "href": "/pts/v2/payments/6843757345116021304951/captures"
    }
  },
  "clientReferenceInformation": {
    "code": "TC50171_3"
  },
  "id": "6843757345116021304951",
  "orderInformation": {
    "amountDetails": {
      "authorizedAmount": "102.21",
      "currency": "USD"
    }
  },
  "paymentAccountInformation": {
    "card": {
      "type": "001"
    }
  },
  "paymentInformation": {
    "accountFeatures": {
      "category": "A"
    },
    "tokenizedCard": {
      "type": "001"
    },
    "card": {
      "type": "001"
    }
  },
  "processorInformation": {
    "approvalCode": "831000",
    "networkTransactionId": "558196000003814",
    "transactionId": "558196000003814",
    "responseCode": "000",
    "avs": {
      "code": "Y",
      "codeRaw": "Y"
    }
  },
  "status": "AUTHORIZED",
  "submitTimeUtc": "2023-05-18T02:08:54Z"
}