Servicio de consulta de la tienda
Después de obtener el token o la firma en el paso anterior, la tienda online puede consumir el servicio de búsqueda de tiendas.
Detalles de la llamada#
- Recurso:
/v1/merchants/{id} - Método HTTP:
GET - Formato de la respuesta:
JSON - Parametros de encabezamiento:
| Parámetro | Descripción | Formato | Obligatorio |
|---|---|---|---|
merchant_id | Código de tienda en el Portal Carat. Los códigos de producción y certificación serán diferentes. | < 15 AN | SIM |
merchant_key | Clave de autenticación para la tienda de pagos online. Las claves de producción y certificación serán diferentes. | < 80 AN | SÍ |
token | Token obtenido del servicio de creación de tokens. Más información. | = 66 AN | NO |
Authorization | La firma de autenticación de la tienda debe enviarse en el formato Bearer {assinatura}. Exemplo: Bearer JHVGytfdgauygdauiw78264284527852897hagdg. | < 2000 AN | NO |
Ejemplo#
Respuesta:
Parámetros de respuesta#
Si tiene éxito, el código de respuesta HTTP será "200". Cualquier otro código debe interpretarse como un error.
| Parámetro | Descripción | Formato | |
|---|---|---|---|
response_code | Código de respuesta de pago. Online. | < 4 N | |
response_message | Mensagem de resposta do Pagamento Online. | < 500 AN | |
id | Código de la tienda consultada. | < 15 AN | |
key | Clave de la tienda consultada. | < 80 AN | |
fantasy_name | Nombre fantasia de la tienda. | < 250 AN | |
corporate_name | Razón social de la tienda. | < 250 AN | |
merchant_status | Estado de la tienda. Puede tomar los siguientes valores: A = Activo I = Inactivo | = 1 AN | |
sitef_merchant_id | Código de empresa de la tienda. | 8 N | |
domain | Domínio (site) de la tienda. | < 65 AN | |
cnpj | CNPJ ou CPF de la tienda. Sólo números. | < 14 N | |
address | Dirección tienda. | < 30 AN | |
city | Ciudad de compras. | < 13 AN | |
state | Estado de la tienda (sigla). | = 2 AN | |
zip_code | CEP de la tienda. | < 9 AN | |
phone_number | teléfono de la tienda | < 30 AN | |
email | Dirección de | ||
| e-mail. | < 100 AN | ||
| transactional_urls | URLs utilizadas en flujos transaccional. | ||
mcc | Merchant Category Code - código que indica la categoría del establecimiento | = 4 N | |
threeds_enabled | Muestra si la tienda está lista para la autenticación mediante 3DS Server. [Más información.] (Pago-html-3ds-server.md) | = 5 N | |
threeds_payment_link_authentication | Tipo de autenticación predeterminado que se mostrará al generar un enlace de pago en el portal de comerciantes. [Más información.] (portal-lojista-pagamento-geracao-link.md)
| = 1 N | NO |
automatic_threeds_minimum_value | Valor mínimo en centavos para que el 3DS se habilite automáticamente. < 12 N | ||
automatic_threeds_maximum_value | Valor máximo en centavos para habilitar 3DS automáticamente. < 12 N | ||
automatic_antifraud_minimum_value | Valor mínimo en centavos para habilitar automáticamente Antifraude. < 12 N | ||
automatic_antifraud_maximum_value | Valor máximo en centavos para habilitar automáticamente Antifraude. < 12 N | ||
antifraud_over_threeds | Marca de la tarjeta que indica que se deniega la funcionalidad para activar el antifraude automáticamente en caso de error o autenticación utilizando el servidor 3DS integrado con Portal Carat | < 5 AN | |
status | URL para recibir avisos de estado. | < 500 AN | |
autenticidad | URL para recibir POST de autenticidad. | < 500 AN | |
hash | URL para recibir el hash / token de la tarjeta almacenada. | < 500 AN | |
| return_urls | URL de amortización HTML. | ||
success | URL de retorno exitosa. | < 500 AN | |
failure | URL de retorno de error. | < 500 AN | |
cancel | Cancelar la URL de retorno. | < 500 AN | |
| permission | Permisos transaccionales que se asignarán a la tienda. Envíe el valor true para habilitar la funcionalidad en cuestión. | ||
payment | Permiso de pago. | < 5 AN | |
pre_authorization | Permiso de preautorización. | < 5 AN | |
recharge | Permiso para recargar. | < 5 AN | |
risk_analysis | Permiso para análisis de riesgos. | < 5 AN | |
schedule | Permiso para programar horario. | < 5 AN | |
iata | Permiso para IATA. | < 5 AN | |
card_store | Permiso para el almacenamiento de tarjetas. | < 5 AN | |
payment_link | Permiso de pago mediante enlace. | < 5 AN | |
| authorizers [] | Autorizadores para registrarse en la tienda. | ||
id | ID del autorizador en el Portal Carat. [Más información.] (autorizadoras.md#códigos-de-autorizadores-no-e-sitef) | < 4 N | |
routing_id | Identificación de enrutamiento / adquirente en el Portal Carat. [Más información.] (# Códigos-de-enrutamiento-adquirente) | < 4 N | |
min_installments_amount | Importe mínimo para cuotas en transacciones HTML. Valor predeterminado: 1000 | < 12 N | |
max_installments_without_interest | Número máximo de cuotas sin intereses en transacciones HTML. Valor predeterminado: 3 | < 2 N | |
max_installments_with_interest | Número máximo de cuotas que devengan intereses en transacciones HTML. Valor predeterminado: 12 | < 2 N | |
purchaser_merchant_id | Identificador de tienda designado por el adquirente. | < 35 AN | |
cvv_mandatory | Habilite el campo de código de seguridad obligatorio de la tarjeta. | < 5 AN | |
| authorizers[].parameters | Parámetros específicos de enrutamiento. [Más información.] (# Parámetros-específicos-de-enrutamiento) |