Generar un enlace de pago

Testee el Web Service Charge/CreatePaymentOrder desde nuestro playground: Charge/CreatePaymentOrder.

Casos de uso

El vendedor desea generar una URL de pago para enviar una propuesta comercial.

Con esta solución, puede personalizar totalmente el mensaje y, si lo desea, añadir un adjunto (como por ejemplo un presupuesto).

También puede obtener el contenido del mensaje generado por la plataforma para utilizarlo en el mensaje que transmitirá al comprador.

El vendedor envía el mensaje.

Solicitud de pago en inmediato

Llame al servicio PCharge/CreatePaymentOrder utilizando los siguientes campos:

CARACTERÍSTICAS	OBLIGATORIO	Descripción
channelOptions.channelType	NO	Parámetro que permite definir el canal de emisión de la solicitud de pago. Su valor puede ser URL o puede no enviarse.
expirationDate	NO	Fecha de vencimiento de la solicitud en formato ISO-8601. No puede ser anterior a la fecha actual ni superar los 90 días. Si este parámetro no está definido, se aplicará el valor de la tienda. Ejemplo: 2021-10-05T21:59:59+00:00
locale	NO	Código que representa el nombre del idioma, compuesto por el código del idioma (ISO 639-1) seguido del código del país (ISO 3166 alpha-2), separados por el carácter "_". Permite definir el idioma de las páginas de pago y el e-mail de confirmación. Si este parámetro no está definido, se utiliza el idioma de la tienda. Por ejemplo: "fr_FR", "es_ES", "en_GB", "pt_BR"
merchantComment	NO	Comentario opcional para el usuario delbom. Se encuentra en el menú:Gestión>Solicitudes de pago: o bien mostrando los detalles del pedido en la pestaña Información del campo`Identifiant utilisateur source`o bien consultando la columna`Informations utilisateur`.
amount	Sí	Monto a pagar, expresado en su fracción monetaria más pequeña (el céntimo para el sol peruano).
currency	Sí	Devise du paiement. Code ISO 4217 alpha-3. Ex: "PEN" pour le sol péruvien.
orderId	NO	Referencia del pedido.
taxAmount	NO	Monto de los impuestos de todo el pedido, expresado en su unidad monetaria más pequeña (el céntimo para el sol peruano).
taxRate	NO	Tipo de impuesto aplicado a todo el pedido. El valor debe ser el porcentaje a aplicar (21 para 21 %).
transactionOptions.cardOptions.manualValidation	NO	Permite definir si la validación de la transacción es manual. Valores posibles: YES \| NO.
transactionOptions.cardOptions.captureDelay	NO	Indica el plazo, en días, antes de su captura.
strongAuthentication	NO	Permite habilitar o deshabilitar la autentificación fuerte durante el pago. Valores posibles: Valores posibles: "ENABLED", "DISABLED", CHALLENGE_REQUESTED, CHALLENGE_MANDATE, NO_PREFERENCE o "AUTO".
paymentReceiptEmail	NO	Dirección de e-mail para el envío del recibo de pago al comprador. Requiere la activación de la regla de notificación "E-mail de confirmación de pago destinado al comprador".
dataCollectionForm	NO	Uso del formulario de recaudación de datos. Valores posibles: "true" o "false".
customer	NO	Objeto que contiene los datos del comprador.
formAction	NO	permite definir el tipo de comportamiento que desea al crear la transacción.
paymentMethodToken	NO	Token del medio de pago que se utilizará para el pago.
paymentMethods	NO	Lista de formas de pago para ofrecer al comprador.
metadata	NO	Valores personalizados adjuntos a la transacción, en formato json.

Existen campos opcionales.
Vea todos los campos de nuestro Playground:Charge/CreatePaymentOrder(menú de la izquierda).

Ejemplo de solicitud

Pago al contado

/doc/es-PE/rest/V4.0/api/kb/authentication.html

https://github.com/lyra/rest-php-examples/blob/master/www/minimalEmbeddedForm.php#L9-L44

https://api.micuentaweb.pe/api-payment/V4/Charge/CreatePaymentOrder

{
    "amount": 10000,
    "currency": "PEN",
    "orderId": "myOrderId-1234",
    "channelOptions": {
      "channelType": "URL"      
    }
}

{
    "amount": 200050,
    "currency": "PEN",
    "orderId": "myOrderId-999999",    
    "channelOptions": {
      "channelType": "URL"      
    },
    "paymentReceiptEmail": "sample@example.com",
    "expirationDate": "2020-04-20T20:13:26+02:00",
    "locale": "es_PE",
    "dataCollectionForm": "false"
}

{
    "amount": 200050,
    "currency": "ARS",
    "orderId": "myOrderId-999999",    
    "channelOptions": {
      "channelType": "URL"      
    },
    "paymentReceiptEmail": "sample@example.com",
    "expirationDate": "2020-04-20T20:13:26+02:00",
    "locale": "es_AR",
    "dataCollectionForm": "false"
}

{
    "amount": 200050,
    "currency": "COP",
    "orderId": "myOrderId-999999",   
    "channelOptions": {
      "channelType": "URL"      
    },
    "paymentReceiptEmail": "sample@example.com",
    "expirationDate": "2020-04-20T20:13:26+02:00",
    "locale": "es_CO",
    "dataCollectionForm": "false"
}

Respuesta

El objeto answer contendrá los siguientes parámetros:

CARACTERÍSTICAS	Descripción
paymentOrderId	ID de la solicitud de pago.
paymentURL	URL de pago.
paymentOrderStatus	Estado de la solicitud de pago.
creationDate	Fecha y hora de creación de la solicitud de pago.
updateDate	Fecha y hora de modificación de la solicitud de pago.
channelDetails.channelType	Canal de transmisión de la solicitud de pago.
mensaje	Mensaje que incluye el enlace de pago, redactado en el idioma de la configuración regional.
amount	Monto a pagar, expresado en la unidad más pequeña de la moneda utilizada.
currency	Moneda del pago. Código ISO 4217 alpha-3.
locale	Código que representa el nombre del idioma, compuesto por el código del idioma (ISO 639-1) seguido del código del país (ISO 3166 alpha-2), separados por el carácter "_".
strongAuthentication	Preferencia del vendedor respecto a la autentificación fuerte.
orderId	Referencia del pedido.
paymentReceiptEmail	Dirección de e-mail para el envío del recibo de pago al comprador.
taxAmount	Monto de los impuestos para todo el pedido, expresado en su unidad monetaria más pequeña.
taxRate	Tipo de impuesto aplicado a todo el pedido.
expirationDate	Fecha de vencimiento de la solicitud en formato ISO-8601.
dataCollectionForm	Uso del formulario de recaudación de datos.
merchantComment	Comentario opcional.
transactionDetails.cardDetails.manualValidation	Modo de validación de la transacción.
transactionDetails.cardDetails.captureDelay	Plazo de captura.
customer	Objeto que contiene los datos del comprador.
formAction	permite definir el tipo de comportamiento que desea al crear la transacción.
paymentMethodToken	Token del medio de pago que se utilizará para el pago.
paymentMethods	Lista de formas de pago para ofrecer al comprador.
metadata	Valores personalizados adjuntos a la transacción, en formato json.

Vea todos los campos de nuestro Playground: PaymentOrder

Ejemplo de respuesta

{
    "webService": "Charge/CreatePaymentOrder",    
    "version": "V4",
    "applicationVersion": "5.5.0",
    "status": "SUCCESS",
    "answer": {
        "paymentOrderId": "fd8f6060f824427ba687d0161e46af8f",
        "paymentURL": "https://secure.micuentaweb.pe/t/328zq5so",
        "paymentOrderStatus": "RUNNING",
        "creationDate": "2020-03-31T15:06:49+00:00",
        "updateDate": null,
        "amount": 200050,
        "currency": "PEN",
        "locale": "en_GB",
        "strongAuthentication": "AUTO",
        "orderId": "myOrderId-1234",
        "channelDetails": {
            "channelType": "URL",
            "mailDetails": null,
            "smsDetails":  null,
            "whatsAppDetails": null,
            "_type": "V4/ChannelDetails"
        },
        "paymentReceiptEmail": "sample@example.com",
        "taxRate": null,
        "taxAmount": null,
        "expirationDate": "2020-04-20T18:13:26+00:00",
        "transactionDetails": {
            "cardDetails": {
                "manualValidation": "NO",
                "captureDelay": 0,
                "_type": "V4/CardDetails"
            },
            "_type": "V4/PaymentOrderTransactionDetails"
        },
        "dataCollectionForm": false,
        "merchantComment": null,
        "message": "I pay PEN 2,000.50 via secure payment before 23/04/2020 (if the link does not work, copy the URL : https://secure.micuentaweb.pe/t/xdt0bcmo ).",
        "_type": "V4/PaymentOrder"
    },
    "ticket": null,
    "serverDate": "2020-03-31T15:06:49+00:00",
    "applicationProvider": "MCW",
    "metadata": null,
    "_type": "V4/WebService/Response"
}


}

Manejo de errores

El Web Service Charge/createPaymentOrder devolverá un error en los siguientes casos:

Código	Descripción
INT_009	El formato del campo amount no es válido o el campo no se ha transmitido.
INT_010	El formato del campo currency no es válido o el campo no se ha transmitido.
INT_050	El parámetro strongAuthentication es inválido.
INT_856	El parámetro locale es inválido.
INT_858	El parámetro taxRate es inválido.
INT_869	El parámetro taxAmount es inválido.
PSP_519	Moneda desconocida.
PSP_606	Moneda no admitida por la afiliación.
PSP_1007	La fecha de vencimiento de la solicitud de pago no puede ser anterior a la fecha actual ni exceder los 90 días.
PSP_1015	No hay ningún formulario de recolección de datos para esta tienda.
PSP_1018	No se puede utilizar el formulario de recolección de datos para la moneda solicitada.

Categoria

Tags