Skip to main content

Refund a Transaction

POST 
/v2/orders/:orderID/transactions/:transactionID/refund

There are two ways to refund; through your payment gateway and mark it refunded in Commerce Manager, or directly through Commerce Manager or API.

  • Mark as Refunded: You can manually mark a transaction as refunded. Before you can mark the order as refunded, you need to handle the actual refund on your side with your payment provider. Mark as Refunded is a full refund made to the transaction.
  • Refund through Composable Commerce: You can process a full or partial refund to a supported payment provider directly from Commerce Manager or API by providing the refund amount. When you start the refund process, the request is directly sent to the payment gateway.
caution

If you use manual gateway for partial or full refund, you need to handle the actual refund on your side with your payment provider.

Request​

Path Parameters

    orderID stringrequired

    The UUID of the order.

    transactionID stringrequired

    The UUID of the transaction you want to refund.

Body

    data object
    amount number

    The amount value to be refunded. If this field is not provided, it will be considered as manual refund (Mark as Refunded) and the refund process must be manually handled via payment provider. If the amount value is same as payment value, then it will be treated as a full refund and sent to the payment provider to process refund automatically.

    options object
    note string

    Provides comments about the refund. It is used by PayPal Express.

Responses​

Response Headers
    Schema
      data object
      id uuid

      The ID of the transaction.

      reference string

      The payment gateway reference.

      name string

      A custom name associated with the payment method.

      custom_reference string

      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.

      gateway string

      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.

      amount number

      The amount for this transaction.

      refunded_amount number

      The refunded amount.

      currency string

      The transaction currency.

      transaction-type string

      The type of transaction, such as purchase, capture, authorize or refund.

      status string

      The status provided by the gateway for this transaction, such as complete or failed.

      relationships object
      order object
      data object
      type string

      Represents the type of the object being returned. It is always order.

      id uuid

      The ID of the order.

      meta object
      display_price object
      amount number

      The raw total of this cart.

      currency string

      The currency set for this cart.

      formatted string

      The tax inclusive formatted total based on the currency.

      display_refunded_amount object
      amount number

      The raw total of this cart.

      currency string

      The currency set for this cart.

      formatted string

      The tax inclusive formatted total based on the currency.

      timestamps object
      created_at string

      The date this was created.

      updated_at

      The date this was last updated.

    Loading...