Confirm Payment
POST/v2/orders/:orderID/transactions/:transactionID/confirm
Confirm Payment serves as a mechanism to synchronize transaction information from the third-party payment provider back to our system. This ensures that Composable Commerce accurately reflects the values from the payment provider.
Handling 3D Secure Validations for Stripe Payments
For Stripe Payments requiring 3D Secure validation, the transaction response will include the client_parameters
object, which provides credentials to support validation of these payment requests on the payment provider's side. We recommend using the Stripe's client libraries to manage these 3D Secure validations. Once the validation succeeds, proceed with a confirmation request to sync the validated transaction into Composable Commerce and continue with the payment process.
Request
Path Parameters
The unique identifier of the order.
The unique identifier of the transaction.
- application/json
Body
Responses
- 200
- 401
Response Headers
- application/json
- Schema
- Example (from schema)
Schema
data object
The ID of the transaction.
The payment gateway reference.
A custom name associated with the payment method.
A reference associated with the payment method. This might include loyalty points or gift card identifiers. We recommend you not to include personal information in this field.
Possible values: [adyen
, authorize_net
, braintree
, card_connect
, cyber_source
, elastic_path_payments_stripe
, manual
, paypal_express_checkout
, stripe
, stripe_connect
, stripe_payment_intents
]
The name of the payment gateway used.
The amount for this transaction.
The refunded amount.
The transaction currency.
The type of transaction, such as purchase
, capture
, authorize
or refund
.
The status provided by the gateway for this transaction, such as complete
or failed
.
relationships object
order object
data object
Represents the type of the object being returned. It is always order
.
The ID of the order.
meta object
display_price object
The raw total of this cart.
The currency set for this cart.
The tax inclusive formatted total based on the currency.
display_refunded_amount object
The raw total of this cart.
The currency set for this cart.
The tax inclusive formatted total based on the currency.
timestamps object
The date this was created.
The date this was last updated.
{
"data": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"reference": "string",
"name": "string",
"custom_reference": "string",
"gateway": "adyen",
"amount": 0,
"refunded_amount": 0,
"currency": "string",
"transaction-type": "string",
"status": "string",
"relationships": {
"order": {
"data": {
"type": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
}
},
"meta": {
"display_price": {
"amount": 0,
"currency": "string",
"formatted": "string"
},
"display_refunded_amount": {
"amount": 0,
"currency": "string",
"formatted": "string"
},
"timestamps": {
"created_at": "string"
}
}
}
}
Unauthorized
- application/json
- Schema
- Example (from schema)
- Example
Schema
[
null
]
{
"errors": {
"status": 401,
"title": "Unauthorized"
}
}