addPayments
post
/ccagent/v1/payment
Add Payments. Add payments to an order.
Request
Supported Media Types
- application/json
Query Parameters
-
includeOrder(optional): boolean
If true, then order will be included in the response.
Root Schema : addPayments_request
Type:
Show Source
object
-
op(optional):
string
operation - inquireBalance - to inquire balance of a GiftCard, initiate - for cash and paypalCehckout
-
orderId:
string
The order ID.
-
payments:
array payments
The array of Payments to be applied to the order.
Example:
{
"orderId":"o80413",
"profileId":"170309",
"payments":[
{
"amount":"15.50",
"customProperties":{
"cust-prop2":"cust-prop2",
"cust-prop1":"cust-prop1"
},
"giftCardNumber":"536564",
"giftCardPin":"123",
"billingAddress":{
"lastName":"Anderson",
"country":"US",
"address2":"",
"city":"Syracuse",
"address1":"21 Cedar Ave",
"postalCode":"13202",
"county":"",
"selectedCountry":"US",
"firstName":"Kim",
"phoneNumber":"212-555-1977",
"state":"New York",
"selectedState":"NY",
"email":"kim@example.com (http://example.com/)",
"state_ISOCode":"US-NY"
},
"paymentMethodType":"physicalGiftCard"
},
{
"cardCVV":"333",
"amount":"19.50",
"customProperties":{
"cust-prop2":"cust-prop2",
"cust-prop1":"cust-prop1"
},
"nameOnCard":"Kim",
"cardType":"visa",
"expiryMonth":"3",
"expiryYear":"2019",
"billingAddress":{
"lastName":"Anderson",
"country":"US",
"address2":"",
"city":"Syracuse",
"address1":"21 Cedar Ave",
"postalCode":"13202",
"county":"",
"selectedCountry":"US",
"firstName":"Kim",
"phoneNumber":"212-555-1977",
"state":"New York",
"selectedState":"NY",
"email":"kim@example.com (http://example.com/)",
"state_ISOCode":"US-NY"
},
"paymentMethodType":"card",
"cardNumber":"4111111111111111"
}
]
}
Nested Schema : items
Type:
Show Source
object
-
amount:
number
Amount to be paid using this paymentMethod.
-
billingAddress(optional):
object billingAddress
The billing address details.
-
cardCVV(optional):
string
Credit/Debit card secret pin. PaymentMethodType: card.
-
cardNumber(optional):
string
Credit/Debit card number used for payment. PaymentMethodType: card.
-
cardType(optional):
string
Credit/Debit card type. e.g. visa. PaymentMethodType: card.
-
customProperties(optional):
object customProperties
Custom object with dynamic properties. This will be passed to the webhook request
-
expiryMonth(optional):
integer
Credit/Debit card expiry month. PaymentMethodType: card.
-
expiryYear(optional):
integer
Credit/Debit card expiry year. PaymentMethodType: card.
-
giftCardNumber(optional):
string
Gift card number used for payment. PaymentMethodType: physicalGiftCard.
-
giftCardPin(optional):
string
Gift card pin. PaymentMethodType: physicalGiftCard.
-
nameOnCard(optional):
string
Name on the credit/debit card. PaymentMethodType: card.
-
nickname(optional):
string
Card nickname
-
PayerID(optional):
string
Payer ID relevant to paypal checkout type. PaymentMethodType: paypalCheckout.
-
paymentGroupId(optional):
string
Payment Group ID relevant to the PaymentMethodType. PaymentMethodType: paypalCheckout, payUWebLatamCheckout.
-
paymentId(optional):
string
Payment ID relevant to the PaymentMethodType. PaymentMethodType: paypalCheckout
-
paymentMethodType:
string
Payment Method Type - payULatamWebcheckout,paypalCheckout,card,invoice,physicalGiftCard,cash
-
PONumber(optional):
string
Purchase order number for invoice payment. PaymentMethodType: invoice
-
saveCard(optional):
boolean
Property that determines whether to save this card or not.
-
savedCardId(optional):
string
Id of the saved card
-
setAsDefault(optional):
boolean
Property to set this card as default card.
-
token(optional):
string
Token relevant to paypal checkout type. PaymentMethodType: paypalCheckout.
Nested Schema : billingAddress
Type:
object
The billing address details.
Show Source
-
address1:
string
Address snippet.
-
address2(optional):
string
Address snippet.
-
address3(optional):
string
Address snippet.
-
alias(optional):
string
Address alias.
-
city:
string
City.
-
companyName(optional):
string
Company name.
-
country:
string
Country.
-
county(optional):
string
County.
-
email(optional):
string
Email.
-
faxNumber(optional):
string
Fax number.
-
firstName:
string
First name.
-
jobTitle(optional):
string
Job title.
-
lastName:
string
Last name.
-
middleName(optional):
string
Middle name.
-
phoneNumber(optional):
string
Phone number.
-
postalCode:
string
Postal code.
-
prefix(optional):
string
Name prefix.
-
selectedCountry:
string
Country code.
-
selectedState:
string
State code.
-
state:
string
State.
-
state_ISOCode:
string
State ISO code.
-
suffix(optional):
string
Name suffix.
Nested Schema : customProperties
Type:
object
Custom object with dynamic properties. This will be passed to the webhook request
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Root Schema : addPayments_response
Type:
Show Source
object
-
embedded(optional):
object embedded
The embedded holder property for the current order representation.
-
items(optional):
array items
The list of added payments.
Nested Schema : embedded
Type:
object
The embedded holder property for the current order representation.
Show Source
Nested Schema : model_order
Type:
Show Source
object
-
creationSiteId(optional):
string
The ID of the site on which the order was created. This may differ to siteId value if the site is part of a cart sharing group.
-
dynamicProperties(optional):
array dynamicProperties
Read-only list of dynamic properties for the order along with meta-data.
-
giftWithPurchaseInfo(optional):
array giftWithPurchaseInfo
The gift information.
-
giftWithPurchaseOrderMarkers(optional):
array giftWithPurchaseOrderMarkers
giftWithPurchaseOrderMarker information.
-
orderAction(optional):
string
The action performed on the order.Example:
order
-
orderId(optional):
string
Order ID of the order.Example:
o10003
-
payments(optional):
array payments
Payment details for the order, including additional properties specific to the payment type.
-
priceListGroup(optional):
object priceListGroup
The price list group object.
-
shippingGroups(optional):
object shippingGroups
The shipping groups in the order.
-
shippingMethod(optional):
object shippingMethod
Shipping Method information of the order.
-
shoppingCart(optional):
object shoppingCart
Shopping cart information.
-
siteId(optional):
string
The ID of the site in which the order was createdExample:
siteUS
Nested Schema : dynamicProperties
Type:
array
Read-only list of dynamic properties for the order along with meta-data.
Show Source
Nested Schema : giftWithPurchaseOrderMarkers
Type:
array
giftWithPurchaseOrderMarker information.
Show Source
Nested Schema : payments
Type:
array
Payment details for the order, including additional properties specific to the payment type.
Show Source
Nested Schema : priceListGroup
Type:
object
The price list group object.
Show Source
-
active(optional):
boolean
Active status of the price list group.Example:
true
-
currency(optional):
object currency
The currency object.
-
deleted(optional):
boolean
Property to determine existence of the price list group.Example:
false
-
displayName(optional):
string
Display name of the price list group.Example:
Default Price Group
-
endDate(optional):
string
end dateExample:
oracle.doceng.json.BetterJsonNull@23756e10
-
isTaxIncluded(optional):
boolean
Whether tax is included.Example:
false
-
locale(optional):
string
Locale of the price list group.Example:
en_US
-
repositoryId(optional):
string
Repository ID of the price list group.Example:
defaultPriceGroup
-
shippingSurchargePriceList(optional):
object shippingSurchargePriceList
Shipping Surcharge PriceList object.
Nested Schema : shippingGroups
Type:
object
The shipping groups in the order.
Show Source
-
discountInfo(optional):
object discountInfo
Discount Information
-
items(optional):
array items
The array of products in the shipping group.
-
priceInfo(optional):
object priceInfo
Price information of the order.
-
shippingAddress(optional):
object shippingAddress
The shipping address details.
-
shippingGroupId(optional):
string
The ID of the shipping group.Example:
sg10032
-
shippingMethod(optional):
object shippingMethod
The shipping method details for the order.
-
type(optional):
string
The type of shipping group e.g. hardgoodShippingGroup, inStorePickupShippingGroup, inStoreTakeWithShippingGroupExample:
hardgoodShippingGroup
Nested Schema : shippingMethod
Type:
object
Shipping Method information of the order.
Show Source
-
cost(optional):
number
Cost of shipping method.Example:
6.5
-
shippingTax(optional):
number
The shipping tax.Example:
0.46
-
value(optional):
string
Shipping method value.Example:
ground
Nested Schema : shoppingCart
Type:
object
Shopping cart information.
Show Source
-
items(optional):
array items
Items in the cart.
-
numberOfItems(optional):
integer
Number of items in the cart.Example:
1
Nested Schema : items
Type:
Show Source
object
-
id(optional):
string
The ID of the dynamic property.Example:
giftWrapMessage123
-
label(optional):
string
The label of the dynamic property.Example:
Gift Wrap Message123
-
value(optional):
string
The value of the dynamic property. The value type depends on how the dynamic property was defined and might be something other than string, such as boolean or number.Example:
newGSMessage45600
Nested Schema : items
Type:
Show Source
object
-
giftWithPurchaseDetail(optional):
string
String identifying the free gift, usually the repository ID of the gift type.Example:
Product_6Dxyi
-
giftWithPurchaseIdentifier(optional):
integer
An identifier used to track which gift selection in the promotion this is. It allows the commerce item marker to link to this one.Example:
-2.3234234355E10
-
giftWithPurchaseQuantityAvailableForSelection(optional):
number
gift quantity available for selectionExample:
1
-
giftWithPurchaseType(optional):
string
The type of the gift. (sku, product)Example:
1
-
promotionId(optional):
string
The gift with purchase promotion IDExample:
promo40001
Nested Schema : items
Type:
Show Source
object
-
automaticQuantity(optional):
number
The quantity of free sku for this gift selection that has already been auto added to the order.Example:
0
-
autoRemove(optional):
boolean
Flag to indicate whether free gifts should be auto removed if the promotion no longer qualifies.Example:
true
-
data(optional):
integer
Identifier to track which gift selection in the promotion this is. It allows the commerce item marker to link to this one.Example:
-2.4564678912E10
-
failedQuantity(optional):
number
The amount of automatic free quantity that failed to be added to the cart due to some pricing error, e.g. invalid site.Example:
0
-
giftDetail(optional):
string
String identifying the free gift, usually the repository ID of the gift type.Example:
Product_6Dxyi
-
giftType(optional):
string
The type of the gift. (sku, product)Example:
product
-
key(optional):
string
atg.gwpExample:
atg.gwp
-
quantity(optional):
number
The total quantity of sku for this gift selection.Example:
1
-
removedQuantity(optional):
number
The amount of free quantity that has since been manually removed by a Shopper.Example:
1
-
selectedQuantity(optional):
integer
The quantity of free sku for this gift selection that has already been selected by the Shopper and added to the order.Example:
0
-
targetedQuantity(optional):
number
The quantity of free sku for this gift selection that has already been targeted and made free by the calculator in the order.
-
value(optional):
string
The gift with purchase promotion IDExample:
promo40001
Nested Schema : items
Type:
Show Source
object
-
amount(optional):
number
Amount authorized from the payment group.Example:
170
-
balance(optional):
number
Total available balance on the gift card.Example:
100
-
gatewayName(optional):
string
Payment gateway name. e.g. chaseCreditCard.Example:
chaseGiftCard
-
giftCardNumber(optional):
string
Gift card number.Example:
6.0483478347347343E18
-
isAmountRemaining(optional):
boolean
A boolean to decide if more payment can be made from this payment group.Example:
true
-
maskedCardNumber(optional):
string
Masked gift card number.Example:
xxxxxxxxxxxxxxxxxx1234
-
paymentGroupId(optional):
string
Payment group ID.Example:
pg70048
-
paymentMethod(optional):
string
Payment method. e.g. physicalGiftCard/ creditCard.Example:
creditCard
-
paymentState(optional):
string
The state of the payment group. e.g. AUTHORIZED.Example:
INITIAL
-
savedCardId(optional):
string
ID of the saved card associated with the payment group.Example:
sc1234
-
uiIntervention(optional):
string
This decides whether the client has to do some intervention for payment. e.g. SOP.Example:
oracle.doceng.json.BetterJsonNull@49fc275f
Nested Schema : currency
Type:
object
The currency object.
Show Source
-
currencyCode(optional):
string
The currency code.Example:
USD
-
displayName(optional):
string
Display name of the currency.Example:
US Dollar
-
fractionalDigits(optional):
integer
Number of fractional digits for the currency.Example:
2
-
numericCode(optional):
string
Numeric code of the currency.Example:
840
-
repositoryId(optional):
string
Repository ID of the currency.Example:
currency
-
symbol(optional):
string
The currency symbol.Example:
$
Nested Schema : shippingSurchargePriceList
Type:
object
Shipping Surcharge PriceList object.
Show Source
-
repositoryId(optional):
string
Repository ID of the shipping surcharge price list.Example:
shippingSurchargePrices
Nested Schema : discountInfo
Type:
object
Discount Information
Show Source
-
discountDescList(optional):
array discountDescList
The list of all the order discounts.
-
orderDiscount(optional):
number
Order DiscountExample:
0
-
orderImplicitDiscountList(optional):
array orderImplicitDiscountList
Implicit Promotions for the order
-
shippingDiscount(optional):
number
Shipping DiscountExample:
0
Nested Schema : priceInfo
Type:
object
Price information of the order.
Show Source
-
amount(optional):
number
Amount of order.Example:
179
-
currencyCode(optional):
string
Currency code for currency being used.Example:
USD
-
primaryCurrencyTotal(optional):
number
The current total in loyalty points in case of multi currencyExample:
204.06
-
shipping(optional):
number
Shipping price of order.Example:
6.5
-
shippingSurchargeValue(optional):
number
Extra handling costs for shipping the products.Example:
0
-
subTotal(optional):
number
Sub total.Example:
179
-
tax(optional):
number
Tax.Example:
18.56
-
total(optional):
number
Total amount of order.Example:
204.06
-
totalWithoutTax(optional):
string
The total without including tax.Example:
185.5
Nested Schema : shippingAddress
Type:
object
The shipping address details.
Show Source
-
address1(optional):
string
Address snippet.Example:
76 Palm Drive
-
address2(optional):
string
Address snippet.Example:
Florida
-
address3(optional):
string
Address snippet.Example:
Florida
-
alias(optional):
string
Address alias.Example:
Address03#
-
city(optional):
string
City.Example:
Orlando
-
companyName(optional):
string
Company name.Example:
Doctor's Place
-
country(optional):
string
Country.Example:
US
-
county(optional):
string
County.Example:
Florida
-
email(optional):
string
Email address.Example:
john@email.com
-
faxNumber(optional):
string
Fax number.Example:
330193316
-
firstName(optional):
string
First name.Example:
John
-
jobTitle(optional):
string
Job title.Example:
Doctor
-
lastName(optional):
string
Last name.Example:
Smith
-
middleName(optional):
string
Middle name.Example:
Joe
-
phoneNumber(optional):
string
Phone number.Example:
09345456345
-
postalCode(optional):
string
Postal code.Example:
32002
-
prefix(optional):
string
Name prefix.Example:
Mr
-
selectedCountry(optional):
string
Country code.Example:
US
-
state(optional):
string
State.Example:
FL
-
suffix(optional):
string
Name suffix.Example:
John Smith
Nested Schema : shippingMethod
Type:
object
The shipping method details for the order.
Show Source
-
cost(optional):
number
The total cost of shipping.Example:
6.5
-
shippingMethodDescription(optional):
string
The description of the shipping method.Example:
Ground
-
shippingTax(optional):
number
The shipping tax.Example:
0.46
-
taxCode(optional):
string
Tax Code.Example:
PC00300
-
taxIncluded(optional):
boolean
Whether tax is includedExample:
true
-
value(optional):
string
The shipping method applied to the order.Example:
ground
Nested Schema : items
Type:
Show Source
object
-
coupon(optional):
string
The coupon code.Example:
FREETATTOO
-
external(optional):
boolean
States whether this promotion was applied by an external system (only present on external promotions).Example:
false
-
promotionDesc(optional):
string
Description of the promotion. Retained for backward compatibility.Example:
Explicit Item Discount - FREETATTOO
-
promotionId(optional):
string
The promotion ID.Example:
explicitItemFreeDiscount
-
promotionLevel(optional):
string
The promotion level.Example:
item
-
promotionName(optional):
string
The display name of the promotion.Example:
Free Tattoo
Nested Schema : items
Type:
Show Source
object
-
external(optional):
boolean
States whether this promotion was applied by an external system (only present on external promotions).Example:
false
-
promotionDesc(optional):
string
Description of the promotion. Retained for backward compatibility.Example:
Implicit Item Discount - 3PercentOff
-
promotionId(optional):
string
The Id of the promotion.Example:
implicitItemPercentDiscount
-
promotionLevel(optional):
string
The promotion level.Example:
item
Nested Schema : items
Type:
Show Source
object
-
asset(optional):
boolean
The flag that determines if the current item is an asset or not.Example:
false
-
availabilityDate(optional):
string
The availability date of commerce Item.Example:
2020-06-30
-
availablePickupDate(optional):
string
The available date (in ISO format) for collection of items to be picked up in store (if shipping group type is inStorePickupShippingGroup).Example:
2020-06-30
-
backOrderQuantity(optional):
number
Back Order Quantity of the Items.Example:
0
-
catRefId(optional):
string
The product variant ID.Example:
Sku_18Cxi
-
commerceItemId(optional):
string
The ID of the commerce item.Example:
ci3000411
-
discountAmount(optional):
number
The value of the discount.Example:
0
-
dynamicProperties(optional):
array dynamicProperties
Array of custom properties at order line item level.
-
inventoryLocationId(optional):
string
Defines the inventory location that services the referenced commerce item.Example:
SiteUS-GlenAllen187
-
onSale(optional):
boolean
Whether the item is on sale or not.Example:
false
-
pointOfNoRevision(optional):
boolean
The boolean that indicates if the item has passed pointOfNoRevision.Example:
false
-
preferredPickupDate(optional):
string
The preferred date (in ISO format) for the items to be picked up in store (if shipping group type is inStorePickupShippingGroup).Example:
2020-06-30
-
preOrderQuantity(optional):
number
The pre order quantity of the items.Example:
0
-
productId(optional):
string
ID of the product in the cart.Example:
Product_18Cxi
-
quantity(optional):
integer
The quantity of the product in this shipping group.Example:
5
-
rawTotalPrice(optional):
number
The raw price of the product.Example:
29.99
-
relationshipType(optional):
string
The type of this relationship. SHIPPINGQUANITY or SHIPPINGQUANTITYREMAINING.
-
returnedQuantity(optional):
integer
Number of referenced items that were returned.Example:
0
-
salePrice(optional):
string
Sale Price.Example:
0
-
shippingSurchargeValue(optional):
number
Extra handling costs for shipping the products.Example:
0
-
siteId(optional):
string
The ID of the site on which the item was added.Example:
siteUS
-
skuProperties(optional):
array skuProperties
Sku properties Information
-
state(optional):
string
state of the commerce ItemExample:
SUBMITTED
-
unitPrice(optional):
number
The price of the item.Example:
29.99
-
variant(optional):
array variant
List of variants for the product.
Nested Schema : dynamicProperties
Type:
array
Array of custom properties at order line item level.
Show Source
Nested Schema : items
Type:
Show Source
object
-
id(optional):
string
The ID of the dynamic property.Example:
dynamicPropertyMode
-
label(optional):
string
The label of the dynamic property.Example:
Mode
-
value(optional):
string
The value of the dynamic property.Example:
pickup
Nested Schema : items
Type:
Show Source
object
-
id(optional):
string
ID of the Dynamic SKU Property.Example:
upcCode
-
name(optional):
string
Name of the Dynamic SKU Property.Example:
UPC Code
-
propertyType(optional):
string
Type that indicates whether it is a base or a custom SKU property,Example:
sku-base
-
value(optional):
string
Value of the Dynamic SKU Property.Example:
12345
Nested Schema : items
Type:
Show Source
object
-
optionName(optional):
string
The variant option name.Example:
color
-
optionValue(optional):
string
The variant option value.Example:
red
Nested Schema : items
Type:
Show Source
object
-
actionCode(optional):
string
The action code that has been set on the item by the configurator system.Example:
Add
-
asset(optional):
boolean
The flag that determines if the current item is an asset or not.Example:
false
-
catRefId(optional):
string
Sku reference ID.Example:
Sku_18Cxi
-
childSkus(optional):
array childSkus
An array with single primary image url for this item's sku, or its default image.
-
commerceItemId(optional):
string
For stateless cart, can be used as a unique line item ID distinguisher.Example:
ci3000411
-
discountAmount(optional):
number
The discount amount.Example:
0
-
displayName(optional):
string
Display Name.Example:
Dora The Explorer
-
dynamicProperties(optional):
array dynamicProperties
Array of custom properties at order line item level.
-
externalData(optional):
array externalData
External data to be associated with a commerce item, provided by a configurator system.
-
giftWithPurchaseCommerceItemMarkers(optional):
array giftWithPurchaseCommerceItemMarkers
giftWithPurchaseCommerceItemMarker information.
-
id(optional):
string
Unique identifier for the line item.Example:
ci3000415
-
isItemValid(optional):
boolean
Whether item is valid or not.Example:
true
-
itemDiscountInfos(optional):
array itemDiscountInfos
Item discount infos
-
originalCommerceItemId(optional):
string
The Commerce Item ID associated with the original item from which item in cancel order is created.Example:
ci3000411
-
pointOfNoRevision(optional):
boolean
The boolean that indicates if the item has passed pointOfNoRevision.
-
price(optional):
number
Price of the items.Example:
21.99
-
primaryImageAltText(optional):
string
The product's primary image alternative text.
-
primaryImageTitle(optional):
string
The product's primary image title.Example:
Samsung - F90BN HD Flash Memory Camcorder
-
primaryThumbImageURL(optional):
string
Product's Primary Thumb Image URL.Example:
ccstore/v1/images/?source=/file/v7023553219093550939/products/Book.jpg&height=100&width=100
-
productId(optional):
string
ID of the product in the cart.Example:
Product_18Cxi
-
quantity(optional):
integer
Quantity of the items.Example:
5
-
rawTotalPrice(optional):
string
Raw Total Price.Example:
179
-
route(optional):
string
The UI route to display the product.
-
shippingSurchargeValue(optional):
number
shipping surcharge value.Example:
0
-
shopperInput(optional):
object shopperInput
Additional Properties Allowed: additionalPropertiesMap of shopper input keys to values
-
siteId(optional):
string
The ID of the site on which the item was added.
-
skuProperties(optional):
array skuProperties
Sku properties Information
-
state(optional):
string
state of the commerce ItemExample:
SUBMITTED
-
variant(optional):
array variant
List of variants for the product.
Nested Schema : childSkus
Type:
array
An array with single primary image url for this item's sku, or its default image.
Show Source
Nested Schema : dynamicProperties
Type:
array
Array of custom properties at order line item level.
Show Source
Nested Schema : externalData
Type:
array
External data to be associated with a commerce item, provided by a configurator system.
Show Source
Nested Schema : giftWithPurchaseCommerceItemMarkers
Type:
array
giftWithPurchaseCommerceItemMarker information.
Show Source
Nested Schema : shopperInput
Type:
object
Additional Properties Allowed
Show Source
Map of shopper input keys to values
Nested Schema : items
Type:
Show Source
object
-
id(optional):
string
The ID of the dynamic property.Example:
giftWrapMessage123
-
label(optional):
string
The label of the dynamic property.Example:
Gift Wrap Message123
-
value(optional):
string
The value of the dynamic property. The value type depends on how the dynamic property was defined and might be something other than string, such as boolean or number.Example:
newGSMessage45600
Nested Schema : items
Type:
Show Source
object
-
actionCode(optional):
string
The action code that has been set on the externalData item by the configurator system.
-
name(optional):
string
The name to be associated with the externalData item.
-
values(optional):
object values
The array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
Show Source
-
dynamic_property_key(optional):
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
Show Source
object
-
automaticQuantity(optional):
number
The quantity of the free gift that this commerce item is making free and was auto added by pricing.Example:
0
-
data(optional):
integer
The gift hash code for this gift with purchase promotion.Example:
-123345466
-
key(optional):
string
atg.gwpExample:
atg.gwp
-
remainingQuantity(optional):
number
The quantity of the commerce item that is not affected by gift with purchase.Example:
0
-
selectedQuantity(optional):
number
The quantity of the free gift that this commerce item is making free and was selected by the shopper.Example:
0
-
targetedQuantity(optional):
number
The quantity of the free gift that this commerce item is making free and was targeted by pricing.Example:
0
-
value(optional):
string
The gift with purchase promotion ID.Example:
promo10002
Nested Schema : items
Type:
Show Source
object
-
amount(optional):
number
Discount amount for itemExample:
10
-
couponCodes(optional):
array couponCodes
Coupon codes applied to the items
-
promotionId(optional):
string
ID of the promotionExample:
promo1111
Nested Schema : couponCodes
Type:
array
Coupon codes applied to the items
Show Source
-
Array of:
string
Example:
TestCouponCode
Nested Schema : items
Type:
Show Source
object
-
id(optional):
string
ID of the Dynamic SKU Property.Example:
displayName
-
name(optional):
string
Name of the Dynamic SKU Property.Example:
name
-
propertyType(optional):
string
Type that indicates whether it is a base or a custom SKU property,Example:
sku-base
-
value(optional):
string
Value of the Dynamic SKU Property.Example:
Sku_18Cxi
Nested Schema : items
Type:
Show Source
object
-
optionName(optional):
string
The variant option name.Example:
color
-
optionValue(optional):
string
The variant option value.Example:
red
Nested Schema : items
Type:
Show Source
object
-
amount(optional):
number
Amount to be authorized from the gift card or store credit.
-
balance(optional):
number
Total available balance on the gift card or store credit.
-
cardType(optional):
string
Credit/Debit card type. e.g. visa. Payment type:card.
-
currencyCode(optional):
string
The currency code. Required for loyaltyPoints payment type.
-
customProperties(optional):
object customProperties
Custom object with dynamic properties. This will be passed to the webhook request
-
endMonth(optional):
string
Credit/Debit card expiry month. Payment type:card.
-
endYear(optional):
string
Credit/Debit card expiry year. Payment type:card.
-
expiryMonth(optional):
string
Credit/Debit card expiry month. Payment type:card.
-
expiryYear(optional):
string
Credit/Debit card expiry year. Payment type:card.
-
gatewayName(optional):
string
Payment gateway name. e.g. chaseGiftCard.
-
giftCardNumber(optional):
string
Gift card number used for payment. Payment type:physicalGiftCard.
-
giftCardPin(optional):
string
Gift card pin. Payment type:physicalGiftCard.
-
IIN(optional):
string
The issuer identification number (first 6 digits) of the IIN payment type card, e.g. credit card. This is normally used to allow any credit card type based promotions to be applied prior to final checkout. (iinPaymentType only)
-
isAmountRemaining(optional):
boolean
A boolean to decide if more payment can be made from this payment.
-
nameOnCard(optional):
string
Name on the credit/debit card. Payment type:card.
-
paymentExpired(optional):
boolean
True if payment details have expried.
-
paymentGroupId(optional):
string
The ID of the Payment Group.
-
paymentMethod(optional):
string
Payment method. e.g. physicalGiftCard/ store credit.
-
paymentState(optional):
string
The state of the payment group. e.g. INITIAL.
-
PONumber(optional):
string
Purchase order number for invoice payment. Payment type:invoice
-
savedCardId(optional):
string
ID of the saved card associated with the payment group.
-
storeCreditNumber(optional):
string
Store credit number used for payment. Payment type:storeCredit.
-
type(optional):
string
Payment type:physicalGiftCard, storeCredit, card, invoice, generic, inStorePayment, cash, loyaltyPoints
Nested Schema : customProperties
Type:
object
Custom object with dynamic properties. This will be passed to the webhook request
Example Response (application/json)
{
"customPaymentProperties":{
"sample-addnl-property-key2":"sample-payment-property-value2",
"cust-prop2":"cust-prop2",
"cust-prop1":"cust-prop1"
},
"orderId":"o50419",
"profileId":"110093",
"amountRemaining":55,
"links":[
{
"rel":"self",
"href":"http://localhost:8080/ccstoreui/v1/payment"
}
],
"paymentResponses":[
{
"paymentGroupId":"pg50414",
"amount":55,
"gatewayName":"PP-A",
"uiIntervention":"REDIRECT",
"paymentMethod":"onlinePaymentGroup",
"transaction_state":"created",
"id":"PAY-48G29628SF768135MLCM36QI",
"paymentState":"INITIAL",
"type":"paypalCheckout",
"intent":"authorize",
"REDIRECT":"https://www.sandbox.paypal.com/cgi-bin/webscr?cmd=_express-checkout&token=EC-9P504127F4036564D"
}
]
}
Default Response
The error response.
The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud:
|Error Code|Description|
|------------------|------------------|
|51173|Error while processing Payments.|
|51174|Your order has not been placed due to a payment error, and you have not been charged. Please try again.|
|51175|An error occurred completing an order payment.|
Root Schema : errorModel
Type:
Show Source
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
errors(optional):
array errors
An optional list of errors if multiple errors were encountered
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code
-
type(optional):
string
The URI to the HTTP state code definition
Nested Schema : errors
Type:
array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type:
Show Source
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code