Skip to content

↑↓ navigate ↵ open Ctrl↵ new tab esc close

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).

GET https://api.rapidchargeback.com/api/v1/merchants/:merchant_id
Authorization: Basic base64(client_id:client_secret)

ParamTypeDescription
merchant_idstring (UUID)The merchant id

This route takes no query params: any parameter in the URL is rejected with 422 VALIDATION_ERROR (Unknown field: <name>).


Terminal window
curl https://api.rapidchargeback.com/api/v1/merchants/00000000-0000-0000-0000-000000000001 \
-H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="

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"
}
}
FieldDescription
id, name, merchant_ref, status, created_at, updated_atThe same as in List merchants
store_nameStore name as the cardholder knows it
merchant_urlStore website
contact_phoneCustomer service phone
emailCustomer service email
mccStore category code (see MCC)
descriptionDescription of what the store sells
logo_urlLogo address
terms, terms_urlTerms of use (text and address)
refund_policy, refund_policy_urlRefund policy (text and address)
customer_service_instructionsHow the cardholder reaches the store
address_street, address_number, address_city, address_state, address_postal_codeAddress
address_countryCountry, 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.

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.