Get merchant
Returns the full registration of one of your company’s merchants. To find the merchant_id, use List merchants (including by merchant_ref, the seller ID in your system).
Endpoint
Section titled “Endpoint”GET
https://api.rapidchargeback.com/api/v1/merchants/:merchant_idAuthentication
Section titled “Authentication”Authorization: Basic base64(client_id:client_secret)URL parameters
Section titled “URL parameters”| Param | Type | Description |
|---|---|---|
merchant_id | string (UUID) | The merchant id |
This route takes no query params: any parameter in the URL is rejected with 422 VALIDATION_ERROR (Unknown field: <name>).
Request example
Section titled “Request example”curl https://api.rapidchargeback.com/api/v1/merchants/00000000-0000-0000-0000-000000000001 \ -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="Response
Section titled “Response”Success
Section titled “Success”HTTP/1.1 200 OK{ "data": { "id": "00000000-0000-0000-0000-000000000001", "name": "Loja Exemplo", "merchant_ref": "PB-1001", "status": "active", "created_at": "2026-03-10T12:00:00.000Z", "updated_at": "2026-11-06T12:00:00.000Z", "store_name": "Loja Exemplo", "merchant_url": "https://lojaexemplo.com", "contact_phone": "+55 11 99999-0000", "email": "contato@lojaexemplo.com", "mcc": "5999", "description": null, "logo_url": null, "terms": null, "terms_url": "https://lojaexemplo.com/termos", "refund_policy": null, "refund_policy_url": "https://lojaexemplo.com/reembolso", "customer_service_instructions": null, "address_street": "Rua Exemplo", "address_number": "100", "address_city": "São Paulo", "address_state": "SP", "address_postal_code": "01000-000", "address_country": "BRA" }}| Field | Description |
|---|---|
id, name, merchant_ref, status, created_at, updated_at | The same as in List merchants |
store_name | Store name as the cardholder knows it |
merchant_url | Store website |
contact_phone | Customer service phone |
email | Customer service email |
mcc | Store category code (see MCC) |
description | Description of what the store sells |
logo_url | Logo address |
terms, terms_url | Terms of use (text and address) |
refund_policy, refund_policy_url | Refund policy (text and address) |
customer_service_instructions | How the cardholder reaches the store |
address_street, address_number, address_city, address_state, address_postal_code | Address |
address_country | Country, 3-letter uppercase code (e.g. BRA) |
A field with no value comes as null. It is the same object that Create or update merchant and Edit merchant return.
Merchant not found
Section titled “Merchant not found”HTTP/1.1 404 Not Found{ "error": { "code": "MERCHANT_NOT_FOUND", "message": "Merchant not found" }}The same 404 applies to a merchant_id that does not exist, belongs to another company or is not a UUID.
- Only your company’s merchants. The company comes from the credential.
- Auth, rate limit, error codes: see Authentication and Response codes.