{
  "opencollection": "1.0.0",
  "info": {
    "name": "Finix Authorizations Merchants API",
    "version": "2022-02-01"
  },
  "request": {
    "auth": {
      "type": "basic",
      "username": "{{username}}",
      "password": "{{password}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Merchants",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Create a Merchant",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://finix.sandbox-payments-api.com/identities/:identity_id/merchants",
            "headers": [
              {
                "name": "Finix-Version",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "identity_id",
                "value": "",
                "type": "path",
                "description": "ID of `Identity` to fetch."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a `Merchant` to start the underwriting (also called provisioning) process for your seller. `Merchants` must be created under an [`Identity`](/api/tag/Identities).\n\nA bank account must be associated with the previously created `Identity` before a `Merchant` can be successfully onboarded and verified."
        },
        {
          "info": {
            "name": "List Merchants",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://finix.sandbox-payments-api.com/merchants",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "query",
                "description": "Filter by `id`."
              },
              {
                "name": "after_cursor",
                "value": "",
                "type": "query",
                "description": "Return every resource created after the cursor value."
              },
              {
                "name": "before_cursor",
                "value": "",
                "type": "query",
                "description": "Return every resource created before the cursor value."
              },
              {
                "name": "created_at.gte",
                "value": "",
                "type": "query",
                "description": "Filter where `created_at` is after the given date."
              },
              {
                "name": "created_at.lte",
                "value": "",
                "type": "query",
                "description": "Filter where `created_at` is before the given date."
              },
              {
                "name": "limit",
                "value": "10",
                "type": "query",
                "description": "The numbers of items to return."
              },
              {
                "name": "updated_at.gte",
                "value": "",
                "type": "query",
                "description": "Filter where `updated_at` is after the given date."
              },
              {
                "name": "updated_at.lte",
                "value": "",
                "type": "query",
                "description": "Filter where `updated_at` is before the given date."
              }
            ]
          },
          "docs": "Retrieve a list of `Merchants`. "
        },
        {
          "info": {
            "name": "Fetch a Merchant",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://finix.sandbox-payments-api.com/merchants/:merchant_id",
            "params": [
              {
                "name": "merchant_id",
                "value": "",
                "type": "path",
                "description": "ID of `Merchant`."
              }
            ]
          },
          "docs": "Retrieve the details of a `Merchant`."
        },
        {
          "info": {
            "name": "Update a Merchant",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://finix.sandbox-payments-api.com/merchants/:merchant_id",
            "headers": [
              {
                "name": "Finix-Version",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "merchant_id",
                "value": "",
                "type": "path",
                "description": "ID of `Merchant`."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Update a `Merchant` to: \n- Change the `Identity` information saved with the underlying processor\n- [Enable Level 2/3 processing](/guides/payments/making-a-payment/level-2-and-level-3-processing/)\n- Enable [buyer charges](/guides/payments/making-a-payment/buyer-charges/)\n- Disable a `Merchant` so the seller can't create new `Transfers` and `Authorizations`."
        },
        {
          "info": {
            "name": "Verify a Merchant",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://finix.sandbox-payments-api.com/merchants/:merchant_id/verifications",
            "headers": [
              {
                "name": "Finix-Version",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "merchant_id",
                "value": "",
                "type": "path",
                "description": "ID of `Merchant` object."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Verify a `Merchant` if the `onboarding_state` for a `Merchant` returns **FAILED**, or if the correct the seller needs to update the saved in their information `Identity`.\n\nRelated Guides: [Onboarding Process](/guides/onboarding/onboarding-process/#reverify-a-merchant)"
        }
      ]
    }
  ],
  "bundled": true
}