1. REST API for Oracle Commerce Cloud 21C
  2. Tasks
  3. Store
  4. Payment

addPayments

post

/ccstore/v1/payment

Add Payments. Add payments to an order.

Request

Supported Media Types
Body ()
Root Schema : addPayments_request
Type: object
Show Source
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 : payments
Type: array
The array of Payments to be applied to the order.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : billingAddress
Type: object
The billing address details.
Show Source
Nested Schema : customProperties
Type: object
Custom object with dynamic properties. This will be passed to the webhook request
Back to Top

Response

Supported Media Types

200 Response

Following model is returned when operation succeeds.
Body ()
Root Schema : addPayments_response
Type: object
Show Source
Nested Schema : embedded
Type: object
Property to return other embedded objects, like order. This gets included in the payload when query parameter includeOrder is passed as true.
Show Source
Nested Schema : paymentResponses
Type: array
The array of payment responses
Show Source
Nested Schema : order
Type: object
The current order representation.
Show Source
Nested Schema : discountInfo
Type: object
Discount Information
Show Source
Nested Schema : dynamicProperties
Type: array
Read-only list of dynamic properties for the order along with meta-data.
Show Source
Nested Schema : giftWithPurchaseInfo
Type: array
The gift information.
Show Source
Nested Schema : giftWithPurchaseOrderMarkers
Type: array
giftWithPurchaseOrderMarker information.
Show Source
Nested Schema : priceInfo
Type: object
Price information of the order.
Show Source
Nested Schema : priceListGroup
Type: object
The price list group object.
Show Source
Nested Schema : recurringChargePriceInfo
Type: object
Recurring charge price information.
Show Source
Nested Schema : shippingGroups
Type: array
The shipping groups for the order.
Show Source
Nested Schema : shippingMethod
Type: object
Shipping Method information of the order.
Show Source
Nested Schema : shoppingCart
Type: object
Shopping cart information.
Show Source
Nested Schema : claimedCouponMultiPromotions
Type: object
The coupons that were claimed.
Show Source
Nested Schema : orderCouponsMap
Type: object
The coupons that were claimed.
Show Source
Nested Schema : orderImplicitDiscountList
Type: array
Implicit Promotions for the order
Show Source
Nested Schema : unclaimedCouponMultiPromotions
Type: object
The coupons that were not claimed
Show Source
Nested Schema : unclaimedCouponsMap
Type: object
The coupons that were not claimed
Show Source
Nested Schema : couponCode
Type: array
Coupon Code, corresponding to which promotions were applied
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : couponCode
Type: object
Coupon Code.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : couponCode
Type: array
Coupon Code, corresponding to which some promotions were not applied
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : couponCode
Type: object
Coupon Code.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : frequencyAmountTotals
Type: array
The total for each recurring charge frequency
Show Source
Nested Schema : frequencyTaxTotals
Type: array
The tax for each recurring charge frequency
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: array
The array of products in the shipping group.
Show Source
Nested Schema : shippingAddress
Type: object
The shipping address details.
Show Source
Nested Schema : shippingMethod
Type: object
The shipping method details for the order.
Show Source
Nested Schema : store
Type: object
Information about the Store from which items are being picked up from (if shipping group type is inStorePickupShippingGroup)
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : dynamicProperties
Type: array
Array of custom properties at order line item level.
Show Source
Nested Schema : skuProperties
Type: array
Sku properties Information
Show Source
Nested Schema : variant
Type: array
List of variants for the product.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: array
Items in the cart.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : childItems
Type: array
The array of child items in the item, if the item is a configurable item. A child item can itself contain child item array if it is a configurable product in itself.
Show Source
Nested Schema : detailedRecurringChargeInfo
Type: object
Detailed Item Price Information.
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 : skuProperties
Type: array
Sku properties Information
Show Source
Nested Schema : variant
Type: array
List of variants for the product.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : detailedRecurringChargeInfo
Type: object
Detailed Item Price Information.
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 : shopperInput
Type: object
Additional Properties Allowed
Show Source
Map of shopper input keys to values
Nested Schema : items
Type: object
Show Source
Nested Schema : values
Type: object
The array of values associated with an externalData item.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : values
Type: object
The array of values associated with an externalData item.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : customPaymentProperties
Type: object
Custom Payment Properties
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.|
Body ()
Root Schema : errorModel
Type: object
Show Source
Nested Schema : errors
Type: array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type: object
Show Source
Back to Top