Saltar al contenido principal

Informar sobre el pago

POST 
/notification
Informar sobre las etapas de pago y el resultado final del pago
Respuestas
Enlace de redirección creado
Schema
    response object
    message string

    informa el identificador de transacción en AP y si el flujo de trabajo ha finalizado correctamente o si se ha producido algún error.

    • NOT TO BE CONFUSED WITH THE STATUS OF THE TRANSACTION, WHICH IS REPORTED IN THE “STATUS” OF THE LAST OPERATION.
    operations object[]
    elemento que contiene o agrupa cada una de las operaciones que se ha realizado sobre la transacción. El n.º de elementos “operation” que contiene es igual al indicado en el “operation-size” del “response”.
  • Array [
    • amount string

    Importe de la transacción.

    currency string

    Possible values: [EUR]

    Moneda de la transacción.

    • Código ISO-4217.3 de la divisa de la transacción (EUR, USD, GBP, etc.).
    • Por ahora solo aceptamos EUR.
    merchantTransactionId string

    Identificador de la transacción en tu plataforma de comercio electrónico.

    operationType string

    Possible values: [DEBIT, CREDIT]

    Tipo de operación.

    payFrexTransactionId string

    Identificador de la transacción en AP.

    • Es conveniente guardarlo para poder realizar transacciones secundarias (liquidación, devolución, etc.) y para localizar la transacción en caso de consulta.
    sorted-order string

    Orden de la operación en el flujo.

    status string

    Possible values: [INITIATED, PENDING, TO_CAPTURE, SUCCESS, SUCCESS_WARNING, ERROR, VOIDED, REBATED, REJECTED, REDIRECTED, AWAITING_PAYSOL, SUCCESS3DS, ERROR3DS, FAIL, N/A (Not Applicable)]

    estado de la transacción tras ser gestionada por la solución de pago o servicio.

    • Si es la última operación, refleja el estado final de la transacción.
    authCode string

    código de autorización del emisor para pagos con tarjeta.

    • Alfanumeríco – 6 caracteres.
    details string

    Respuesta sin tratar de la solución de pago.

    mpi object
    respuesta de 3DSv2 que contiene información sobre la autenticación en pagos con tarjeta.
    eci string

    Resultado del intento de autenticación.

    paymentCode string

    Código de respuesta original de la solución de pago.

    • El formato y los valores dependen de cada solución de pago.
    paymentDetails object
    Destalles de la tarjeta o cuenta del cliente
    account string

    Cartera o n.º de cuenta del cliente

    cardHolderName string

    Titular de la tarjeta

    cardNumber string

    N.º de tarjeta enmascarado

    • Numérico – Max. 19 dígitos.
    • Ejemplo: 4907270002222227 → 490727******2227
    • Necesario su almacenado en tu plataforma de comercio electrónico si se van a realizar transacciones posteriores sobre la tarjeta, como pagos recurrentes.
    cardNumberToken string

    Referencia de la tarjeta del cliente generada por AP

    • Alfanumérico – 16~20 caracteres.
    cardType string

    Possible values: [VISA, MASTERCARD, AMEX]

    Marca de la tarjeta.

    expDate string

    Fecha de caducidad de la tarjeta.

    • Numérico – 4 dígitos.
    • Formato: MMAA - MM los dos dígitos del mes y AA los dos últimos dígitos del año.
    • Por ejemplo: Junio 2023 → 0623
    extraDetails object[]
    Elemento con información extra del servicio o solución de pago que ha gestionado la transacción. * Los posibles valores y formatos dependerán del servicio o solución de pago que lo genere.
  • Array [
    • key string

    Nombre de la clave extra.

    value string

    Valor de la clave extra.

  • ]
    • issuerBank string

    Nombre del banco emisor de la tarjeta.

    issuerCountry string

    País del banco emisor de la tarjeta.

    paymentMessage string

    Mensaje original de la respuesta de la solución de pago o servicio que ha gestionado la transacción.

    paymentSolution string

    Nombre de la solución de pago que ha gestionado la transacción.

    • Cuando se recibe este parámetro no se recibirá el parámetro “service”.
    paySolTransactionId string

    Identificador de la transacción en la solución de pago.

    • El formato depende de cada solución de pago.
    rad string

    Datos adicionales de la respuesta.

    • Sólo disponible en algunos emisores de tarjeta.
    radMessage string

    Mensaje recibido junto a los datos adicionales de la respuesta.

    • Sólo disponible en algunos emisores de tarjeta.
    redirectionResponse string

    URL a la cual tu plataforma de comercio electrónico tiene que redirigir al cliente para completar el pago.

    respCode object
    código de respuesta de AP. Mapea los diferentes códigos de respuesta de los diferentes servicios y soluciones de pago a una serie de códigos unificados.
    message string

    Mensajes de respuesta de AP..

    uuid string

    UUID interno de AP generado para la transacción.

    service string

    Nombre del servicio que ha gestionado la transacción.

    • Cuando se recibe este parámetro no se recibirá el parámetro “paymentSolution”
    subscriptionPlan string

    Identificador para pagos recurrentes. * Necesario su almacenado en tu plataforma de comercio electrónico si se van a realizar transacciones posteriores como pagos recurrentes.

  • ]
    • status string
    workFlowResponse object
    Elemento que informa el nombre y versión del flujo de trabajo que ha gestionado la petición.
    id string

    Identificador interno del flujo de trabajo en AP.

    name string

    Nombre del flujo de trabajo.

    version string

    Versión del flujo de trabajo.

Cargando...