<- Regresar a la documentación
6.10. Agregar registro de pagos masivos (Dispersión).
Este método permite crear elementos(items) de un lote que esté pendiente por cargar
Importante: Si el usuario no tiene un lote creado, el método automaticamente crea un lote de tipo dispersión en estado pendiente por cargar, y a dicho lote le agrega el elemento(item) cargado.
URL: api/multipayment/register-item.json
Método HTTP: POST
Parametros:
type
= Los valores sonDISPERSION
(transferencia interbancaria con una duración de 24h),DISPERSION_INSTANT_INTERBANK
(transferencia interbancaria inmediata - aplican comisiones diferentes)
Datos minimos a enviar
{
"multi_payment_item": {
"reference": "0001",
"nameAccount": "Witty Growth",
"identificationNumber": "j54637469",
"bankAccount": "01340000000000000000",
"amount": "20"
}
}
Ejemplo de Petición
curl -X GET \
'https://test.mpandco.com/api/multipayment/register-item.json?type=DISPERSION' \
-H 'cache-control: no-cache' \
-d '{
"multi_payment_item": {
"reference": "0001",
"nameAccount": "Witty Growth",
"identificationNumber": "j54637469",
"bankAccount": "01340000000000000000",
"amount": "20"
}
}'
Respuesta (Código 200)
{
"ref":"MP19122800001",
"identification_number":"j54637469",
"status":"APPROVED"
}
Importante: Debe verificar el estado de la respuesta sea “APPROVED”
Respuesta (Error 400)
{
"code":400,
"message":"Validation Failed",
"errors":
{
"errors":["No se ha encontrado un banco para el numero de cuenta ingresado"],
"children":
{
"reference":{},
"nameAccount":{},
"identificationNumber":{},
"amount":{},
"bankAccount":{}
}
}
}