This section describes the top-level properties and the properties of subobjects sent in the JSON request body for cash transactions.
Top-level properties
The following table describes the top-level properties that Oracle Commerce Cloud Service sends in the webhook request.
Property | Description |
|---|---|
paymentId | The ID of the internal payment group. |
transactionId | The unique ID of the transaction. Consists of the order ID, the payment ID, and the transaction timestamp (in milliseconds), separated by hyphens. |
transactionType | For a cash payment gateway, this must be one of the following strings:
|
transactionTimestamp | The timestamp of the transaction, expressed as an ISO 8601 value in the following format:
|
channel | The area of the system where the payment-processing request originated. Valid values are:
|
paymentMethod | For a cash payment gateway, the value must be |
orderId | The ID of the order associated with the payment. |
amount | The amount to be authorized, as a positive, 12-digit number that is expressed in base currency to two significant digits. For example, $125.75 is represented as |
currencyCode | The ISO 4217 currency code. |
locale | The shopper’s locale, taken from the order. If no locale is set, the default locale from the storefront is used. |
gatewayId | The ID of the payment gateway. |
profile properties
The following table describes the properties of the profile object in the request. These values are associated with the customer purchasing the order.
Property | Description |
|---|---|
id | The ID of the customer profile. |
phoneNumber | The phone number from the customer profile. |
The email address from the customer profile. |
Sample authorization request
The following is an example of an authorization request sent by the Generic Payment webhook to a cash payment gateway:
{
"transactionId": "o30446-pg30417-1458555741310",
"currencyCode": "USD",
"paymentId": "pg30417",
"locale": "en",
"gatewaySettings": {
"paymentMethodTypes": "cash",
"filteredFields": ["paymentMethodTypes"]
},
"amount": ""000000122526",",
"transactionType": "CASH REQUEST",
"transactionTimestamp": "2016-03-21T10:22:21+0000",
"channel": "storefront",
"orderId": "o30446",
"paymentMethod": "cash",
"gatewayId": "gatewayDemo",
"profile": {
"id": "110454",
"phoneNumber": "617-555-1977",
"email": "tshopper@example.com"
}
}
