Update a merchant profile

You can request an update to a merchant profile with the API. If you use Swan's Web Banking interface, merchants can request an update through their app.

Request an update for the merchant's name, website, product type, expected monthly payment volume, expected average basket, and logo. All updates are reviewed by Swan.

Guide

1. Call the requestMerchantProfileUpdate mutation. You don't need consent.
2. Include only the information you wish to update.
   • Possible fields: merchantName, productType, expectedMonthlyPaymentVolume, expectedAverageBasket.
3. Configure the success payload to display the updated information in case you need to verify it.
4. Add relevant payload and rejection details (not shown) to your mutation.
   • In the following example, the expectedAverageBasket, or expected average transaction, changed from €50 to €75 (line 8). Therefore, request the updated basket in the success payload (lines 12-14).

Mutation

🔎 Open the mutation in API Explorer

mutation ProfileUpdate {
  requestMerchantProfileUpdate(
    input: {
      merchantProfileId: "$MERCHANT_PROFILE_ID"
      expectedAverageBasket: { value: "75", currency: "EUR" }
    }
  ) {
    ... on RequestMerchantProfileUpdateSuccessPayload {
      __typename
      requestMerchantProfileUpdate {
        status
        expectedAverageBasket {
          currency
          value
        }
      }
    }
  }
}

Payload

The payload confirms your update request to an average basket of €75 with the status PendingReview.

{
  "data": {
    "requestMerchantProfileUpdate": {
      "__typename": "RequestMerchantProfileUpdateSuccessPayload",
      "requestMerchantProfileUpdate": {
        "status": "PendingReview",
        "expectedAverageBasket": {
          "currency": "EUR",
          "value": "75"
        }
      }
    }
  }
}