> ## Documentation Index
> Fetch the complete documentation index at: https://docs-stage.bglobale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Send RMA Info to Merchant (from Global-e)

> Global-e posts a MerchantReturn object (including the RMA number) to a merchant-hosted endpoint via the SendRMAInfoMerchant (Global-e to Merchant) API.

<Note>
  Part of the [RMA Notifications (from Global‑e)](/rma-notifications--from-global-e-) integration guide — see it for when and how to use this endpoint.
</Note>


## OpenAPI

````yaml api-reference/specs/sendrmainfomerchant.yaml POST /rma-info-to-merchant-url
openapi: 3.0.3
info:
  title: SendRMAInfoMerchant (Global-e to Merchant)
  version: 1.0.0
  x-scaled-review: true
  description: >-
    Send Return Merchandise Authorization (RMA) to the merchant. Global-e calls
    this API after a customer generates a label from the Return Portal. This API
    streamlines the refund process for merchants: merchants can initiate refunds
    directly from the Shopify Admin, and it supports Shopify's ability to get
    the return shipping fee when creating a return in their system. The
    MerchantAppSetting SendRMAInfoMerchantURI must be set to turn on this
    feature. (Also referred to as SendRMAToMerchant.)
servers:
  - url: https://{merchant_site_domain}
    variables:
      merchant_site_domain:
        default: www.merchant-site-domain.com
        description: The merchant's site domain hosting the rma-info-to-merchant endpoint.
security: []
tags:
  - name: SendRMAInfoMerchant (Global-e to Merchant)
    x-page-title: Send RMA Info to Merchant (from Global-e)
  - name: 'Direction: Global-e → Merchant'
  - name: 'Domain: Orders'
paths:
  /rma-info-to-merchant-url:
    post:
      tags:
        - SendRMAInfoMerchant (Global-e to Merchant)
      summary: Send RMA Info to Merchant (from Global-e)
      description: >-
        Send Return Merchandise Authorization (RMA) to the merchant. Global-e
        calls this API after a customer generates a label from the Return
        Portal. Sends the MerchantReturn object to the merchant.
      operationId: sendRMAInfoMerchant
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MerchantReturn'
            example:
              OrderId: GE24192321GB
              MerchantOrderId: '71144'
              RMANumber: '223878'
              ShipperName: DHL
              ReturnTrackingNumber: '857854854778'
              TrackingURL: www.dhl.com/Tracking?TrackingNumber=857854854778
              CreatedBy: Customer
              ReturnedProducts:
                - SKU: ProductD
                  Name: Blue jacket
                  CartItemId: '2'
                  ReturnQuantity: 1
                  ReturnReasonName: Arrived too late
                  MerchantReturnReasonCode: null
                  MerchantReturnReasonName: null
              MerchantGUID: 7e3d5523-d86a-4c56-8f47-5a48b829e3b7
              CurrencyCode: EUR
              ReturnShippingCost: 2020.9483
              WebStoreCode: Merchant01
              WebStoreInstanceCode: 01.webstore.com
      responses:
        '200':
          description: >-
            API call response info. Check the `Success` field to distinguish
            success from failure; on failure, `Message` and `Description` carry
            the error text.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseInfo'
              examples:
                success:
                  summary: Success
                  value:
                    Success: 'True'
                    Message: success message
                    Description: success description
                failure:
                  summary: Failure
                  value:
                    Success: 'False'
                    Message: error message
                    Description: error description
components:
  schemas:
    MerchantReturn:
      type: object
      title: MerchantReturn
      description: Provides merchant return information.
      additionalProperties: true
      required:
        - CreatedBy
        - MerchantGUID
        - OrderId
        - ReturnedProducts
        - ReturnTrackingNumber
        - RMANumber
        - ShipperName
        - TrackingURL
      properties:
        CreatedBy:
          type: string
          description: Who created the return
        CurrencyCode:
          type: string
          description: Code for the RMA currency
        MerchantGUID:
          type: string
          description: Unique identifier of the Merchant on Global-e.
        MerchantOrderId:
          type: string
          description: Order unique identifier on the Merchant's site
        OrderId:
          type: string
          description: Global-e order unique identifier.
        ReturnedProducts:
          type: array
          description: Array of returned products
          items:
            $ref: '#/components/schemas/MerchantReturnProduct'
        ReturnShippingCost:
          type: number
          description: Cost for return shipping
        ReturnTrackingNumber:
          type: string
          description: The return tracking number
        RMANumber:
          type: string
          description: Unique RMA number
        ShipperName:
          type: string
          description: The shipper name
        TrackingURL:
          type: string
          description: The return tracking URL
        WebStoreCode:
          type: string
          description: Code for the web store
        WebStoreInstanceCode:
          type: string
          description: Code for the web store instance
    ResponseInfo:
      type: object
      title: ResponseInfo
      description: >-
        Indicates if the call has succeeded. Contains the Success, Message, and
        Description attributes.
      properties:
        Success:
          type: string
          description: >-
            Indicates if the call has succeeded. "True" - Call succeeded.
            "False" - Denotes an error or failure. Sent as a string; Global-e
            parses it case-insensitively (via bool.TryParse), so "true"/"false"
            are also accepted. A missing or non-parseable value is treated as
            failure.
        Message:
          type: string
          nullable: true
          description: >-
            Optional response message. In case of an error, this property
            indicates the error message text.
        Description:
          type: string
          nullable: true
          description: >-
            Optional response description. In case of an error, this property
            indicates the error message description.
    MerchantReturnProduct:
      type: object
      title: MerchantReturnProduct
      description: A returned product.
      required:
        - SKU
        - Name
        - CartItemId
        - ReturnQuantity
        - ReturnReasonName
      properties:
        SKU:
          type: string
          description: Stock keeping unit
        Name:
          type: string
          description: Name of product
        CartItemId:
          type: string
          description: The ID of the cart item
        ReturnQuantity:
          type: string
          description: Return quantity
        ReturnReasonName:
          type: string
          description: Reason for return
        MerchantReturnReasonCode:
          type: string
          nullable: true
          description: Merchant code for return reason
        MerchantReturnReasonName:
          type: string
          nullable: true
          description: Merchant name for return reason

````