Update a Merchant Profile

Overview

Update the linked Fee Profile, Payout Profile, or Risk Profile on a Merchant Profile. This allows you to change the configuration profiles associated with a Merchant.

Resource Access

• User Permissions: Admin users only
• Endpoint: PUT /merchant_profiles/\{merchant_profile_id}

Arguments

Parameter	Type	Required	Description
merchant_profile_id	string	Yes	The unique ID of the Merchant Profile to update
fee_profile	string	No	The ID of the new Fee Profile to link
card_present_fee_profile	string	No	The ID of the new Card Present Fee Profile to link
payout_profile	string	No	The ID of the new Payout Profile to link
risk_profile	string	No	The ID of the new Risk Profile to link

Example Request

curl -X PUT \
  'https://api.ahrvo.network/payments/na/merchant_profiles/MPpqhH8XuQk2TSXf66dE9Nvx' \
  -u username:password \
  -H 'Content-Type: application/json' \
  -d '{
    "fee_profile": "FPnew8G7SzjYYJeKQqRCXJPe",
    "payout_profile": "PPnewVB9WcxFYJeKQqRCXJPe",
    "risk_profile": "RPnewMZd3vYFYJeKQqRCXJPe"
  }'

Example Response

{
  "id": "MPpqhH8XuQk2TSXf66dE9Nvx",
  "created_at": "2023-01-15T10:30:00Z",
  "updated_at": "2023-06-20T14:45:30Z",
  "application": "APvHR8dn8F4FZxRCHLKzgqxv",
  "fee_profile": "FPnew8G7SzjYYJeKQqRCXJPe",
  "card_present_fee_profile": "FPcp5KNj8RtQxYJeKQqRCXJPe",
  "payout_profile": "PPnewVB9WcxFYJeKQqRCXJPe",
  "risk_profile": "RPnewMZd3vYFYJeKQqRCXJPe",
  "tags": {
    "merchant_type": "retail",
    "region": "west"
  },
  "_links": {
    "self": {
      "href": "https://api.ahrvo.network/payments/na/merchant_profiles/MPpqhH8XuQk2TSXf66dE9Nvx"
    },
    "application": {
      "href": "https://api.ahrvo.network/payments/na/applications/APvHR8dn8F4FZxRCHLKzgqxv"
    },
    "fee_profile": {
      "href": "https://api.ahrvo.network/payments/na/fee_profiles/FPnew8G7SzjYYJeKQqRCXJPe"
    },
    "payout_profile": {
      "href": "https://api.ahrvo.network/payments/na/payout_profiles/PPnewVB9WcxFYJeKQqRCXJPe"
    },
    "risk_profile": {
      "href": "https://api.ahrvo.network/payments/na/risk_profiles/RPnewMZd3vYFYJeKQqRCXJPe"
    }
  }
}

Additional Information

• Profile Updates: You can update any combination of the linked profiles in a single request
• Fee Profile Changes:
  • Updating the fee_profile changes pricing for standard transactions
  • Updating the card_present_fee_profile changes pricing for in-person card transactions
• Payout Profile Changes: Modifying the payout profile affects settlement timing and routing for future settlements
• Risk Profile Changes: Updating the risk profile changes velocity limits and fraud thresholds
• Immediate Effect: Profile changes take effect immediately for new transactions
• Validation: The system validates that the specified profile IDs exist and belong to the same Application
• Audit Trail: The updated_at timestamp reflects when the profile was last modified