Este endpoint permite crear un perfil de pago para un cliente y así reaprovechar esos datos para pagos automáticos o recurrentes. En caso de éxito, la solicitud devolverá una respuesta con el estado 201.
POST
REQUERIDO
REQUERIDO
REQUERIDO
400Error
payment_method_id_cannot_be_blank
La solicitud falló porque no se envió ningún valor para el campo "payment_method_id". En "details" es posible obtener más detalles sobre el error. Verifica que los datos enviados sean correctos y vuelve a intentarlo.
payment_methods_cannot_be_null
La solicitud falló porque no se envió ningún medio de pago. En "details" es posible obtener más detalles sobre el error. Verifica que los datos enviados sean correctos y vuelve a intentarlo.
payment_methods_required
La solicitud falló porque no se envió ningún objeto con información sobre el medio de pago. En "details" es posible obtener más detalles sobre el error. Verifica que los datos enviados sean correctos y vuelve a intentarlo.
payment_method_token_or_card_id_required
La solicitud falló porque no se envió ni en "card_token" ni el "card_id" cuando por lo menos uno de ellos es requerido para la creación de perfil de pago. En "details" es posible obtener más detalles sobre el error. Verifica que los datos enviados sean correctos y vuelve a intentarlo.
html_insertion_not_allowed
La solicitud falló porque se enviaron tags HTML en campos que no lo permiten. En "details" es posible obtener más detalles sobre el error. Verifica que los datos enviados sean válidos y vuelve a intentarlo.
max_day_overdue_out_of_range
La solicitud falló porque el valor enviado para el campo "max_day_overdue" no cumple con los valores permitidos. En "details" es posible obtener más detalles sobre el error. Verifica que los datos enviados sean correctos y vuelve a intentarlo.
validation_error
La solicitud falló por un error de validación en los campos enviados. En "details" es posible obtener más detalles sobre el error. Verifica que los datos enviados sean correctos y vuelve a intentarlo.
payload_failed
La solicitud falló, posiblemente por un error de formato o datos inválidos. En "details" es posible obtener más detalles sobre el error. Verifica que los datos enviados sean correctos y vuelve a intentarlo.
multiple_default_payment_methods_not_allowed
La solicitud falló porque se superó el máximo de medios de pago default permitidos. Recuerda que solo puedes definir un medio de pago con el campo "default_method" = true.
more_than_two_payment_methods_not_allowed
La solicitud falló porque enviaron más de dos objetos conteniendo medios de pago, que es el máximo permitido para la creación del perfil. Revisa la solicitud y verifica haber enviado correctamente ese nodo.
two_cards_with_token_not_allowed
La solicitud falló porque no está permitido crear un perfil de pago con dos tarjetas con "card_token" como medio de pago. Revisa la solicitud para enviar ambos objetos de manera correcta.
duplicate_payment_method_not_allowed
La solicitud falló porque hay un medio de pago duplicado. No está permitido agregar nuevamente un medio de pago ya existente en el perfil de pago.
invalid_site_id_for_fintoc
La solicitud falló porque el site_id al que pertenece el usuario que está creando el perfil de pago no es válido para el medio de pago "fintoc", que solo está disponible para Chile. Verifica estar enviando las credenciales correctas o crea un perfil utilizando un medio de pago válido para tu país.
profile_modification_not_allowed
La solicitud falló porque se está queriendo modificar un perfil con estado cancelado, lo que no está permitido. Verifica que el estado del perfil de pago sea correcto antes de intentar realizar cambios.
payment_method_validation_failed
La solicitud falló porque no pudo ser realizada la validación del medio de pago. Intenta nuevamente más tarde y, si el problema persiste, contacta a Soporte con los detalles del error.
customer_id_mismatch
La solicitud falló porque el "customer_id" enviado no coincide con el perfil de pago. Verifica haber enviado el valor correcto y vuelve a intentarlo.
caller_id_mismatch
La solicitud falló porque el "caller_id" no coincide con el perfil de pago. Verifica que el valor enviado es correcto y vuelve a intentarlo.
site_id_mismatch
La solicitud falló porque el "site_id" no coincide con el perfil de pago. Asegúrate de que sea correcto y corresponda al perfil de pago.
unknown_error_occurred
Error desconocido. Contacta a Soporte para obtener más información.
401Error
header_missing
La solicitud falló porque hay un header obligatorio que no fue enviado. Asegúrate de enviar todos los headers necesarios.
Unauthorized Access Token
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la requisición enviando el valor correcto.
402Error de procesamiento
payment_method_not_approved
La solicitud falló porque el pago para la validación del medio de pago no fue aprobado. Verifica que la información de pago sea válida y suficiente para completar la transacción o utiliza un medio de pago diferente.
404Error
resource_not_found
La solicitud falló porque el perfil de pago no fue encontrado. Verifica que el ID del perfil, el ID del cliente y el ID del solicitante sean correctos.
429Error
Too Many Requests
La solicitud falló porque se excedió la frecuencia de solicitudes. Reduce la frecuencia o implementa un sistema de reintentos con backoff exponencial.
500Error
internal_server_error
La solicitud falló por un error interno del servidor. Por favor, vuelve a intentar más tarde y, si el problema persiste, ponte en contacto con Soporte con los detalles del error.
curl -X POST \
'https://api.mercadopago.com/v1/customers/{customer_id}/payment-profiles'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
-H 'X-Idempotency-Key: 5a949030-822e-476b-8b82-5cca4fbb7c64' \
-d '{
"description": "Test payment profile",
"max_day_overdue": 5,
"statement_descriptor": "Test Descriptor",
"sequence_control": "MANUAL",
"payment_methods": [
{
"id": "visa",
"type": "credit_card",
"token": "12345",
"default_method": false
}
]
}'{
"id": "7036b192b541454fa9b9990660dfa1b5",
"created_date": "2024-05-22T14:03:28.653Z",
"last_updated_date": "2024-05-22T14:03:28.653Z",
"description": "Test payment profile",
"max_day_overdue": 5,
"statement_descriptor": "Test Descriptor",
"status": "READY",
"sequence_control": "AUTO",
"payment_methods": [
{
"payment_method_id": "64abf0f5-3e15-48a5-9be0-a8ac56bbd87a",
"id": "visa",
"type": "credit_card",
"card_id": 1234567890,
"status": "READY",
"default_method": true
}
]
}