A merchant_profile
links a merchant
to it's risk_profile
and fee_profile
. Each merchant
has a merchant_profile
.
When a merchant
gets created, a merchant_profile
also gets created. This new merchant_profile
automatically receives a new risk_profile
and fee_profile
that are copies of the risk and fee profiles on the application_profile
.
Related Guides: Collecting Fees
Retrieve a list of merchant_profiles
.
For details on how to query endpoints using the available parameters, see Query Parameters.
Single merchant profile object
Authentication information is missing or invalid
Forbidden
Not Acceptable
curl "https://finix.sandbox-payments-api.com/merchant_profiles" \ -H "Finix-Version: 2022-02-01" \ -u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e
{- "_embedded": {
- "merchant_profiles": [
- {
- "id": "MPnXB4UBGtSUfxwA41z2Hqid",
- "created_at": "2022-10-10T05:20:18.12Z",
- "updated_at": "2022-10-10T05:21:01.42Z",
- "application": "APgPDQrLD52TYvqazjHJJchM",
- "fee_profile": null,
- "payout_profile": "PO8ki51uFGkLYaWyBVJ7oyAt",
- "risk_profile": "RPqzvQLoHk37r74aE6NZ4aXt",
- "tags": { },
- "_links": {
- "self": {
}, - "application": {
}, - "risk_profile": {
}
}
}, - {
- "id": "MPo85BavSYVrkDn57BLh1JTs",
- "created_at": "2022-09-21T17:46:06.29Z",
- "updated_at": "2022-09-21T17:46:07.75Z",
- "application": "APgPDQrLD52TYvqazjHJJchM",
- "fee_profile": null,
- "payout_profile": "PO9AtdBb4FUQqbMm3SAyoX3z",
- "risk_profile": "RP5PUJVynFoHibX6eHtfebV3",
- "tags": { },
- "_links": {
- "self": {
}, - "application": {
}, - "risk_profile": {
}
}
}
]
}, - "_links": {
}, - "page": {
- "offset": 0,
- "limit": 20,
- "count": 1671
}
}
Retrieve the details of a previosuly created merchant_profile
.
Single merchant profile object
Authentication information is missing or invalid
Forbidden
Object does not exist
Not Acceptable
curl "https://finix.sandbox-payments-api.com/merchant_profiles/MPsdo8WPP5erWzfPwMjYjVy3" \ -H "Finix-Version: 2022-02-01" \ -u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e
{- "id": "MPsdo8WPP5erWzfPwMjYjVy3",
- "created_at": "2022-08-15T21:37:47.26Z",
- "updated_at": "2022-08-15T21:38:24.02Z",
- "application": "APgPDQrLD52TYvqazjHJJchM",
- "card_present_fee_profile": null,
- "fee_profile": null,
- "payout_profile": null,
- "risk_profile": "RPwAziDZginXDWuuiDSaA3wr",
- "tags": { },
- "_links": {
- "self": {
}, - "application": {
}, - "risk_profile": {
}
}
}
Update a merchant_profile
.
Single merchant profile object
Authentication information is missing or invalid
Forbidden
Not Acceptable
curl "https://finix.sandbox-payments-api.com/merchant_profiles/MPsdo8WPP5erWzfPwMjYjVy3" \ -H "Content-Type: application/json" \ -H "Finix-Version: 2022-02-01" \ -u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e \ -X PUT \ -d ' { "fee_profile": "FP4xXhxyFRiRePKBQXmueVTh" }'
{- "id": "MPsdo8WPP5erWzfPwMjYjVy3",
- "created_at": "2022-08-15T21:37:47.26Z",
- "updated_at": "2022-08-15T21:38:24.02Z",
- "application": "APgPDQrLD52TYvqazjHJJchM",
- "card_present_fee_profile": null,
- "fee_profile": null,
- "payout_profile": null,
- "risk_profile": "RPwAziDZginXDWuuiDSaA3wr",
- "tags": { },
- "_links": {
- "self": {
}, - "application": {
}, - "risk_profile": {
}
}
}