bloqueos transaccionales

Servicio de Bloqueos Transaccionales

Esta herramienta te permite gestionar diferentes tipos de bloqueos por un período determinado:

  • Comercio: podrás bloquear por su nombre exacto, ID o código MCC.
  • País: podrás bloquear ingresando el código de país

Para cada tipo de bloqueo, podrás:

  • Bloquear por el período predeterminado de un mes o personalizar la duración
  • Gestionar y monitorear tus bloqueos activos

Crear bloqueo

Este endpoint te permite bloquear comercios ingresando su nombre exacto, ID o código MCC. También podrás bloquear países ingresando el código código ISO 3166-1 alfa-3.

Podrás personalizar la duración del bloqueo o usar el período predeterminado de un mes.

Parámetros disponibles
Header Parameters
Authorizationstringrequired
Header de restricción
Ejemplo: Bearer {access_token}
Body Parameters
merchant_idstringrequired
ID del Comercio
Ejemplo: 123456799999
expiration_datestringrequired
Fecha de expiración del bloqueo.
Ejemplo: 3000-01-01T13:40:23Z
Path Parameters
typestringrequired
Tipo de bloqueo
Enum: merchant_idmerchant_mccmerchantcountry
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

POST/fraud/{type}/block
{
"merchant_id":
"123456799999"
"expiration_date":
"3000-01-01T13:40:23Z"
}
Ejemplo de respuestas
{
"data":{
"message":
"BLOCKLIST applied successfully."
}
}

Actualizar bloqueo

Este endpoint te permite modificar la duración de un bloqueo transaccional.
Parámetros disponibles
Header Parameters
Authorizationstringrequired
Header de restricción
Ejemplo: `Bearer {access_token}`
Body Parameters
merchant_idstringrequired
ID del Comercio
Ejemplo: 123456799999
expiration_datestringrequired
Fecha de expiración del bloqueo.
Ejemplo: 3000-01-01T13:40:23Z
Path Parameters
typestringrequired
Tipo de bloqueo
Enum: merchant_idmerchant_mccmerchantcountry
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

PUT/fraud/{type}/block
{
"merchant_id":
"123456799999"
"expiration_date":
"3000-01-01T13:40:23Z"
}
Ejemplo de respuestas
{
"data":{
"message":
"BLOCKLIST applied successfully."
}
}

Eliminar bloqueo

Este endpoint te permite eliminar un bloqueo activo usando su identificador.
Parámetros disponibles
Path Parameters
typestringrequired
Tipo de bloqueo
Enum: merchant_idmerchant_mccmerchantcountry
identifierrequired
Identificador del bloqueo
Ejemplo: `'FACEBOOK-MARKET*12345'`
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

DELETE/fraud/{type}/block/{identifier}
Ejemplo de respuestas
{
"data":{
"message":
"BLOCKLIST deleted successfully."
}
}

Obtener estado de bloqueo

Este endpoint te permite revisar si existe un bloqueo activo usando su identificador.
Parámetros disponibles
Path Parameters
typestringrequired
Tipo de bloqueo
Enum: merchant_idmerchant_mccmerchantcountry
identifierrequired
Identificador del bloqueo
Ejemplo: `'FACEBOOK-MARKET*12345'`
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

GET/fraud/{type}/block/{identifier}
Ejemplo de respuestas
{
"data":{
"message":
"FACEBOOK*MARKET"
"applied_date":
"2021-01-01T12:00:00Z"
}
}

Obtener listado de bloqueos

Este endpoint te permite obtener un listado paginado de bloqueos transaccionales activos. El tipo de bloqueo se especifica en la URL y puede ser:

  • Comercios: bloqueos por nombre de comercio, ID de comercio o MCC de comercio
  • Países: bloqueos por país

Consideraciones

Los resultados se muestran de forma paginada para facilitar su visualización. Puedes controlar la paginación usando los siguientes parámetros:

  • page[number]: Número de página a mostrar (comienza en 0)
  • page[size]: Cantidad de elementos por página

Filtros disponibles

Dependiendo del tipo de bloqueo seleccionado en la URL, puedes usar los siguientes filtros:

  • Para bloqueos de tipo merchant:

    • filter[type]=id: Lista bloqueos por ID de comercio
    • filter[type]=mcc: Lista bloqueos por código MCC
  • Para bloqueos de tipo country:

    • filter[type]=code: Lista bloqueos por código de país (ISO 3166-1 alpha-3)

Ejemplos

Para listar bloqueos de comercios por ID: GET /fraud/search/merchant/block?page[number]=0&page[size]=10&filter[type]=id

Para listar bloqueos por país: GET /fraud/search/country/block?page[number]=0&page[size]=10&filter[type]=code

Parámetros disponibles
Header Parameters
Authorizationstringrequired
Ejemplo: Bearer {access_token}
Query Parameters
page[size]number
Tamaño de página.
page[number]number
Número de página. El número de la primer página es 0.
Path Parameters
typestringrequired
Tipo de bloqueo
Enum: merchantmerchant_mccmerchant_idcountry
Detalle de respuestas
dataarray

¿Te resultó útil esta sección?

GET/fraud/search/{type}/block
Ejemplo de respuestas
{
"data":[
0:{
...
}
]
}