Payments API v3 (1.0.4)
The Payments API is used to send payment requests to process transactions.
https://docs.nelnetpay.com/_mock/apis/osi-payments-api/
https://api.uat.nelnetpay.com/payments-api/
A unique ID assigned by NPS that represents the client.
Indicates the type of payment. Only one type of payment is allowed.
Indicates the type of transaction.
Information about the payment facilitator. Contact NPS Client Services before sending information in this field.
Information for stored card transactions. Required to be sent only for recurring transactions.
Additional amount that is added to the amount of the cardholder's original transaction.
A unique ID returned by the Risk Service.
Mandatory for ACH transactions.
For transactions where the merchant sets the processingMode
field value to SYNCHRONOUS
, we will process these transactions in real-time using existing flows.
For transactions where the merchant sets the processingMode
field value to ASYNCHRONOUS
, we will process these transactions asynchronously.
We will queue the transaction for processing later.
Format Type: String
- Mock server
https://docs.nelnetpay.com/_mock/apis/osi-payments-api/payments
- UAT
https://api.uat.nelnetpay.com/payments-api/payments
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.nelnetpay.com/_mock/apis/osi-payments-api/payments \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-H 'nps-trace-uuid: string' \
-d '{
"entityId": 1325691045,
"paymentType": {
"ach": {
"bankAccount": {
"accountNumber": "459887746321Z",
"routingNumber": "021000021",
"accountType": "CHECKING"
}
}
},
"transactionType": "ACH_DEBIT",
"amount": 123.65,
"accountHolder": {
"accountHolderName": "John Smith",
"accountHolderId": "134267"
},
"transactionInformation": {
"customId": "330d4c38-7904-47cf-be8e-0972a93f7386",
"description": "tuition",
"additionalPaymentInformation": "U00102",
"companyName": "College Prep",
"companyDiscretionaryData": "Test1234",
"standardEntryCode": "WEB",
"terminalCity": "MPLS",
"terminalState": "MN",
"discretionaryData": "R",
"effectiveEntryDate": "250110",
"originalTransactionType": "",
"originalPaymentTransactionId": "80503dc9-15f8-430a-8622-3cff38124bbd"
},
"riskId": "12e3cdac-d347-4564-ba1f-305e5e1e8ded"
}'
OK
Response code defined by NPS indicating status of request.
Format Type: Alphanumeric
Length: 4 to 5
Unique transaction identifier. This value is used when sending a subsequent transaction such as a Capture or Refund.
Format Type: UUID
Length: 36
The ACH account validation return code, which indicates if ACH validation was performed.
ACH Response
{ "responseCode": "A100", "responseMessage": "Approved", "paymentTransactionId": "80503dc9-15f8-430a-8622-3cff38124bbd", "paymentType": { "ach": { … } }, "riskResponse": { "responseCode": "0", "riskId": "12e3cdac-d347-4564-ba1f-305e5e1e8ded", "data": { … } }, "accountValidationResult": { "responseCode": "1", "thirdPartyResponseCode": "2", "bankName": "UB Bank" } }