permisos transaccionales

Servicio de permisos Transaccionales

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

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

Para cada tipo de permiso, podrás:

  • permitir por el período predeterminado de un mes o personalizar la duración
  • Gestionar y monitorear los permisos activos.

Crear permiso

Este endpoint te permite otorgar permisos a comercios ingresando su nombre exacto, ID o código MCC. También podrás permitir países ingresando el 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 permiso.
Ejemplo: 3000-01-01T13:40:23Z
Path Parameters
typestringrequired
Tipo de permiso
Enum: merchant_idmerchant_mccmerchantcountry
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

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

Actualizar permiso

Este endpoint te permite modificar la duración del permiso.
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 permiso.
Ejemplo: 3000-01-01T13:40:23Z
Path Parameters
typestringrequired
Tipo de permiso
Enum: merchant_idmerchant_mccmerchantcountry
Detalle de respuestas
dataobject

¿Te resultó útil esta sección?

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

Eliminar permiso

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

¿Te resultó útil esta sección?

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

Obtener estado de permiso

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

¿Te resultó útil esta sección?

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

Obtener listado de permisos

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

  • Comercios: permisos por nombre de comercio, ID de comercio o MCC de comercio
  • Paises: permisos 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:

pagede página a mostrar (comienza en 0)

pagede elementos por página

Filtros disponibles Dependiendo del tipo de permiso seleccionado en la URL, puedes usar los siguientes filtros:

Para permisos de tipo comercio:

filter[type]=id: Lista permisos por ID de comercio

filter[type]=mcc: Lista permisos por código MCC

Para permisos de tipo país:

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

Ejemplos

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

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

Parámetros disponibles
Header Parameters
AuthorizationEliminar permisostringrequired
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 permiso
Enum: merchantmerchant_mccmerchant_idcountry
Detalle de respuestas
dataarray

¿Te resultó útil esta sección?

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