On This Page
FILTER BY TAG

Authorization for Pre-Pay Scenario

Use this information to process an authorization for a Pre-Pay transaction. For more information about this payment service, see Pre-Pay Transaction Scenario.

Endpoint

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

Required Fields for an Authorization in Pre-Pay Scenario

Set the value to
Pre-Pay Auth
.
Cybersource
 provides the value for this field.
Cybersource
 provides the value for this field.
Cybersource
 provides the value for this field.
Set this value to
2
.
A value is required for online PIN transactions.
A value is required for online PIN transactions.
A value is required for online PIN transactions.
This field is required when within project scope. Merchant configuration must support multiple terminal IDs. Otherwise,
Cybersource
 uses the default terminal ID in the merchant configuration.
Set the value to
0
.
Set the value to
retail
.

REST Example: Authorization for Visa in Pre-Pay Scenario

Request
{
  "clientReferenceInformation": {
    "code": "test123",
    "comments": "Pre-Pay Auth",
    "partner": {
      "developerId": "prodDeveloperId",
      "thirdPartyCertificationNumber": "prodTPCN",
      "solutionId": "prodSolutionId"
    },
    "transactionId": "UniqueTranID"
  },
  "processingInformation": {
    "commerceIndicator": "retail",
    "authorizationOptions": {
      "authIndicator": 0
    }
  },
  "paymentInformation": {
    "card": {
      "type": "001"
    }
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "20.00",
      "currency": "USD"
    }
  },
  "pointOfSaleInformation": {
    "catLevel": 2,
    "entryMode": "contact",
    "terminalCapability": 4,
    "terminalPinCapability": 0,
    "terminalId": "87654321",
    "emv": {
      "tags": "9F100706011103A000009F26089302EDF8DC3C6E519F02060000000011009F0306000000000000
9F1A020840950500000000005F2A0208409A031807039C01009F37043444BDD7820200009F360200019F330360B0E8
9F1E04123456789F2701809F6E0420700000
9F7C140000000000000000000000000000000000000000",
      "cardSequenceNumber": "01"
    },
    "trackData": ";4761739xx1010135=28122011758928889?"
  },
  "merchantInformation": {
    "transactionLocalDateTime": "20250516115959"
  }
}
Response to a Successful Request
{
  "_links": {
    "authReversal": {
      "method": "POST",
      "href": "/pts/v2/payments/7474186405046592803814/reversals"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/payments/7474186405046592803814"
    },
    "capture": {
      "method": "POST",
      "href": "/pts/v2/payments/7474186405046592803814/captures"
    }
  },
  "clientReferenceInformation": {
    "code": "test123",
    "comments": "Pre-Pay Auth",
    "partner": {
      "developerId": "prodDeveloperId",
      "solutionId": "prodSolutionId"
    },
    "transactionId": "UniqueTranID"
  },
  "id": "7474186405046592803814",
  "orderInformation": {
    "amountDetails": {
      "authorizedAmount": "20.00",
      "currency": "USD"
    }
  },
  "paymentAccountInformation": {
    "card": {
      "type": "001"
    }
  },
  "paymentInformation": {
    "accountFeatures": {
      "category": "F",
      "group": "0"
    },
    "tokenizedCard": {
      "type": "001"
    },
    "card": {
      "type": "001"
    }
  },
  "pointOfSaleInformation": {
    "emv": {
      "tags": "9F36020001910A7D517A9478FA6AD53030"
    }
  },
  "processorInformation": {
    "systemTraceAuditNumber": "067278",
    "paymentAccountReferenceNumber": "V0010013018036783719331133719",
    "approvalCode": "057619",
    "networkTransactionId": "305136650405819",
    "settlementDate": "5141",
    "retrievalReferenceNumber": "513618067278",
    "transactionId": "305136650405819",
    "responseCode": "00",
    "avs": {
      "code": "2"
    }
  },
  "reconciliationId": "7474186405046592803814",
  "status": "AUTHORIZED",
  "submitTimeUtc": "2025-05-16T18:04:01Z"
}
RELATED TO THIS PAGE