Absorb Integration API (v2)
Download OpenAPI specification:Download
Get e-commerce transaction.
Authorizations:
path Parameters
| transactionId required | string <guid> The E-commerce transaction ID. |
header Parameters
| x-api-key | string |
| x-api-version | string 2 |
Responses
Response Schema: application/json
| id | string <guid> The unique E-commerce transaction identifier. |
| paymentGatewayTransactionId | string The transaction's payment gateway transaction ID. |
| transactionDate | string The transaction's creation date. |
| transactionCompletedDate | string The transaction's completion date (done by payment gateway or admin approval). |
| status | string The transaction's status. Possible values: Approved, Declined, PendingApproval |
Array of objects (EcommerceTransactionDetailResource) The transaction's shopping cart items. | |
| paymentMethod | integer Enum: 1 2 4 8 16 The transaction's method of payment. Possible Enum Values: |
| cardType | string The transaction's credit card type. |
| maskedCardNumber | string The transaction's last 4 digits of the credit card. |
| billingFirstName | string First name of the person responsible for payment. |
| billingLastName | string Last name of the person responsible for payment. |
| billingAddress | string Address of the person responsible for payment. |
| billingEmailAddress | string Email address of the person responsible for payment. |
| learnerEmailAddress | string Email address of the learner receiving the course/enrollment key(s). |
| learnerFirstName | string First name of the learner receiving the course/enrollment key(s). |
| learnerLastName | string Last name of the learner receiving the course/enrollment key(s). |
| referenceNumber | string The transaction's reference number. |
| couponCode | string The transaction's coupon code used. |
| provinceTaxLabel | string The transaction's provincial tax name. |
| provinceTax | number <decimal> The transaction's dollar amount of provincial tax. |
| countryTaxLabel | string The transaction's country tax name. |
| countryTax | number <decimal> The transaction's dollar amount of country tax. |
| discount | number <decimal> The transaction's dollar amount of discount. |
| subTotal | number <decimal> The transaction's subtotal before taxes and discounts. |
| totalAmount | number <decimal> The transaction's total amount actually paid. |
| paymentGatewayMessage | string The transaction's message from payment gateway. |
| paymentGatewayResult | string The transaction's result from payment gateway. Meaning depends on type of payment gateway. |
| paymentGatewayMessageCode | string The transaction's message code from payment gateway. Meaning depends on type of payment gateway. |
| userId | string <guid> The transaction's user ID. |
| isNewUser | boolean Indicates if this transaction was started by a new Absorb user. |
| isRefunded | boolean Indicates if this transaction was refunded. |
| refundDate | string The transaction's refund date. |
| quantity | integer <int32> The transaction's quantity of seats purchased. This value applies to each shopping cart item. |
Response samples
- 200
- 404
{- "id": "string",
- "paymentGatewayTransactionId": "string",
- "transactionDate": "string",
- "transactionCompletedDate": "string",
- "status": "string",
- "details": [
- {
- "id": "string",
- "courseId": "string",
- "courseName": "string",
- "sessionId": "string",
- "sessionName": "string",
- "price": 0
}
], - "paymentMethod": 1,
- "cardType": "string",
- "maskedCardNumber": "string",
- "billingFirstName": "string",
- "billingLastName": "string",
- "billingAddress": "string",
- "billingEmailAddress": "string",
- "learnerEmailAddress": "string",
- "learnerFirstName": "string",
- "learnerLastName": "string",
- "referenceNumber": "string",
- "couponCode": "string",
- "provinceTaxLabel": "string",
- "provinceTax": 0,
- "countryTaxLabel": "string",
- "countryTax": 0,
- "discount": 0,
- "subTotal": 0,
- "totalAmount": 0,
- "paymentGatewayMessage": "string",
- "paymentGatewayResult": "string",
- "paymentGatewayMessageCode": "string",
- "userId": "string",
- "isNewUser": true,
- "isRefunded": true,
- "refundDate": "string",
- "quantity": 0
}List e-commerce transactions.
Can be filtered by userId, courseId, transactionDate, transactionCompletedDate, and paymentGatewayTransactionId.
Authorizations:
query Parameters
| userId | string <guid> The specified user ID to filter by. |
| courseId | string <guid> The specified course ID to filter by. |
| transactionDate | string <date-time> The specified creation date to filter by. |
| transactionCompletedDate | string <date-time> The specified completion date to filter by. |
| paymentGatewayTransactionId | string The specified payment gateway transaction ID to filter by. |
header Parameters
| x-api-key | string |
| x-api-version | string 2 |
Responses
Response Schema: application/json
| id | string <guid> The unique E-commerce transaction identifier. |
| paymentGatewayTransactionId | string The transaction's payment gateway transaction ID. |
| transactionDate | string The transaction's creation date. |
| transactionCompletedDate | string The transaction's completion date (done by payment gateway or admin approval). |
| status | string The transaction's status. Possible values: Approved, Declined, PendingApproval |
Array of objects (EcommerceTransactionDetailResource) The transaction's shopping cart items. | |
| paymentMethod | integer Enum: 1 2 4 8 16 The transaction's method of payment. Possible Enum Values: |
| cardType | string The transaction's credit card type. |
| maskedCardNumber | string The transaction's last 4 digits of the credit card. |
| billingFirstName | string First name of the person responsible for payment. |
| billingLastName | string Last name of the person responsible for payment. |
| billingAddress | string Address of the person responsible for payment. |
| billingEmailAddress | string Email address of the person responsible for payment. |
| learnerEmailAddress | string Email address of the learner receiving the course/enrollment key(s). |
| learnerFirstName | string First name of the learner receiving the course/enrollment key(s). |
| learnerLastName | string Last name of the learner receiving the course/enrollment key(s). |
| referenceNumber | string The transaction's reference number. |
| couponCode | string The transaction's coupon code used. |
| provinceTaxLabel | string The transaction's provincial tax name. |
| provinceTax | number <decimal> The transaction's dollar amount of provincial tax. |
| countryTaxLabel | string The transaction's country tax name. |
| countryTax | number <decimal> The transaction's dollar amount of country tax. |
| discount | number <decimal> The transaction's dollar amount of discount. |
| subTotal | number <decimal> The transaction's subtotal before taxes and discounts. |
| totalAmount | number <decimal> The transaction's total amount actually paid. |
| paymentGatewayMessage | string The transaction's message from payment gateway. |
| paymentGatewayResult | string The transaction's result from payment gateway. Meaning depends on type of payment gateway. |
| paymentGatewayMessageCode | string The transaction's message code from payment gateway. Meaning depends on type of payment gateway. |
| userId | string <guid> The transaction's user ID. |
| isNewUser | boolean Indicates if this transaction was started by a new Absorb user. |
| isRefunded | boolean Indicates if this transaction was refunded. |
| refundDate | string The transaction's refund date. |
| quantity | integer <int32> The transaction's quantity of seats purchased. This value applies to each shopping cart item. |
Response samples
- 200
- 422
[- {
- "id": "string",
- "paymentGatewayTransactionId": "string",
- "transactionDate": "string",
- "transactionCompletedDate": "string",
- "status": "string",
- "details": [
- {
- "id": "string",
- "courseId": "string",
- "courseName": "string",
- "sessionId": "string",
- "sessionName": "string",
- "price": 0
}
], - "paymentMethod": 1,
- "cardType": "string",
- "maskedCardNumber": "string",
- "billingFirstName": "string",
- "billingLastName": "string",
- "billingAddress": "string",
- "billingEmailAddress": "string",
- "learnerEmailAddress": "string",
- "learnerFirstName": "string",
- "learnerLastName": "string",
- "referenceNumber": "string",
- "couponCode": "string",
- "provinceTaxLabel": "string",
- "provinceTax": 0,
- "countryTaxLabel": "string",
- "countryTax": 0,
- "discount": 0,
- "subTotal": 0,
- "totalAmount": 0,
- "paymentGatewayMessage": "string",
- "paymentGatewayResult": "string",
- "paymentGatewayMessageCode": "string",
- "userId": "string",
- "isNewUser": true,
- "isRefunded": true,
- "refundDate": "string",
- "quantity": 0
}
]Approves or denies an e-commerce transaction.
Authorizations:
path Parameters
| transactionId required | string <guid> The E-commerce transaction ID. |
header Parameters
| x-api-key | string |
| x-api-version | string 2 |
Request Body schema: application/json
The status of the transaction.
| status | string Status of the transaction. Accepted values:
|
Responses
Request samples
- Payload
{- "status": "string"
}Response samples
- 404
- 409
- 422
{- "validations": [
- "string"
], - "code": 0,
- "message": "string",
- "term": "string",
- "_meta": {
- "property1": "string",
- "property2": "string"
}
}