Casos de uso

• Cómo ofrecer al comprador que guarde su tarjeta
• Cómo hacer un registro de tarjeta sin pago
• Pago en un solo clic: mostrar la lista de tarjetas guardadas
• Pago en un solo clic: rellenar previamente el formulario con una tarjeta guardada

Cada uno de estos casos de uso se gestiona directamente desde la primera etapa del pago. Es decir, al enviar la solicitud Charge/createPayment.

Cómo ofrecer al comprador que guarde su tarjeta

Si desea ofrecer al comprador que registre su tarjeta, es necesario:

• Indique el e-mail del comprador en elCharge/createPayment,
• Ingresar la referencia del comprador (se recomienda encarecidamente ya que se puede utilizar más adelante para el pago un clic),
• Enviar el parámetroformAction : ASK_REGISTER_PAY.

Es responsabilidad del comerciante garantizar que la referencia del comprador sea única.

Ejemplo de solicitud:

{
    "amount": ...,
    "currency": ...,
    "orderId": "myOrderId",
    "formAction" : "ASK_REGISTER_PAY",
    "customer": {
        "reference": "cust-25634",
        "email": "joh.doe@mail.com"
    }
}

Cuando el comprador introduce su tarjeta en el formulario de pago, si la tarjeta es apta para el registro, se le dará automáticamente la opción de registrar su tarjeta marcando la casilla correspondiente. Si el comprador marca la casilla y el pago se realiza con éxito, la respuesta contendrá el ID del alias creado que puede utilizarse para rellenar previamente el formulario de pago.

Cómo hacer un registro de tarjeta sin pago

Si desea guardar una tarjeta sin hacer un pago, debe:

• Llamar al WSCharge/createTokenen lugar deCharge/createPayment,
• Indicar el e-mail del comprador en la solicitudCharge/createToken,
• Ingresar la referencia del comprador (se recomienda encarecidamente ya que se puede utilizar más adelante para el pago un clic).

En este caso, el usuario podrá dar de alta su tarjeta sin realizar ningún pago. La gestión de errores se mantiene.

Pago en un solo clic: mostrar la lista de tarjetas guardadas

Si desea ofrecer la lista de tarjetas guardadas al comprador, es necesario:

• Asegurarse de que las tarjetas que registre estén asociadas a la referencia del comprador, es decir, al parámetrocustomer.reference.
• Definir el parámetrocustomer.referenceen el Servicio WebCharge/createPayment.
• Asignar el campo formAction en los pagos aCUSTOMER_WALLETen la solicitudCharge/createPayment.

{
    "amount": ...,
    "currency": ...,
    "orderId": "myOrderId",
    "formAction": "CUSTOMER_WALLET", 
    "customer": {
        "reference": "cust-25634",
        "email": "joh.doe@mail.com"
    }
}

Si en su empresa se han registrado una o más tarjetas con la referencia del comprador transferida como parámetro, se ofrecerán automáticamente al comprador en el formulario de pago.

El comprador también tiene la posibilidad de pagar con otra tarjeta. Gracias al parámetro formAction: CUSTOMER_WALLET, podrá registrar esta nueva tarjeta.

Pago en un solo clic: rellenar previamente el formulario con una tarjeta guardada

Esto significa que, al registrar una tarjeta, obtiene el identificador del token de la tarjeta en la respuesta del SDK. El identificador del token se indica en el parámetro transaction.paymentMethodToken.

Es entonces posible pasarlo en la consulta Charge/createPayment en el parámetro: paymentMethodToken.

{
    "amount": ...,
    "currency": ...,
    "orderId": "myOrderId",
	"paymentMethodToken": "268431681321684321681"
}

El SDK mostrará un formulario de pago de solo lectura previamente completado, el comprador solo deberá ingresar el CVV de ser necesario.