Use Merchant of Record sellers with PaymentIntents

After you create and approve a Merchant of Record (MoR) seller, include that seller when you create a PaymentIntent for the seller's transaction. This ties the payment to the screened seller under your platform MoR account.

This guide applies when you collect payments directly as MoR. For general PaymentIntent setup, see PaymentIntents.

Before you begin

• An MoR platform account that can create PaymentIntents.
• A seller with status ACTIVE from Create a sellerAPI / Retrieve a sellerAPI. Use the seller id returned by those endpoints.
• An access tokenAPI for the platform account.

Attach a seller to a PaymentIntent

Call Create a PaymentIntentAPI and pass the seller in order.sellers. Set order.sellers[].identifier to the MoR seller id from the Seller API.

If you also send product-level seller data, keep order.products[].seller.identifier consistent with order.sellers[].identifier. Prefer order.sellers over the older per-product seller object.

1curl -X POST https://api.sandbox.airwallex.com/api/v1/pa/payment_intents/create \
2  -H 'Authorization: Bearer {{ACCESS_TOKEN}}' \
3  -H 'Content-Type: application/json' \
4  -d '{
5    "request_id": "b01737e5-c5ab-4765-8834-cbd92dfeaf81",
6    "amount": 100,
7    "currency": "USD",
8    "merchant_order_id": "D202503210001",
9    "return_url": "https://www.example.com/checkout/complete",
10    "order": {
11      "sellers": [
12        {
13          "identifier": "2ec93632-07c6-4afc-8519-25da56f3931a",
14          "name": "AIRWALLEX SG"
15        }
16      ]
17    }
18  }'

In this example, order.sellers[].identifier is the seller id returned when you created the seller.

Next steps

• Continue with your usual PaymentIntent confirm and capture flow. See PaymentIntents.
• Split funds to connected accounts if required. See Collect payments directly and Manage funds split.
• Return to Manage Merchant of Record sellers for create, status, and deactivate.