Samsung Pay

Como funciona#

Cuando el comprador hace clic en el botón de pago de Samsung Pay, se muestran los métodos de pago guardados en la cuenta de Samsung Pay. El comprador puede seleccionar rápidamente el método de pago deseado y, opcionalmente, completar la información de compra adicional. Luego de esta interacción con Samsung Pay, estos mismos datos serán enviados / procesados ​​por Portal Carat para llevar a cabo el flujo de pago.

Para obtener más información sobre el flujo de pago con wallets, consulte la página Descripción general


Datos de registro obligatorios#

En casos de integración a través de API REST, el comerciante deberá utilizar el ID de servicio de Software Express con Samsung. Para obtener la identificación del servicio de entorno de producción / aprobación, comuníquese con nuestro equipo de soporte.

Banderas compatibles#

Portal Carat admite las siguientes redes de tarjetas disponibles en Samsung Pay (Brasil):

Acrónimo en Samsung PayBandera
VIVisa
MCMasterCard

Pago / Autorización previa REST#

En la modalidad de Pago o Autorización previa el minorista debe realizar la primera parte de la integración con Samsung Pay (todos los pasos de integración hasta obtener el Reference ID). Comuníquese con el soporte de Samsung para obtener más detalles.

O Reference ID luego debe pasarse a nuestras interfaces REST.

Enviar datos a Portal Carat#

Después de completar la primera parte de la integración con Samsung Pay, tendrá la Reference ID.

Estos datos deben ser transmitidos por el campo. card.wallet_transaction_id de la interfaz.

curl -X POST \
https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/v1/payments/<NIT> \
--header "Content-Type: application/json" \
--header "merchant_id: <MERCHANT_ID>" \
--header "merchant_key: <MERCHANT_KEY>" \
--data-binary '{
"authorizer_id": "410",
"card": {
"wallet_transaction_id": "exemploReferenceId"
}
}'

En el ejemplo anterior, se definió en el campo authorizer_id con valor 410, que corresponde a seleccionar Samsung Pay como método de pago; y se definió en el campo wallet_transaction_id con el valor de Reference ID da Samsung Pay . La ejecución exitosa del comando anterior devolverá un JSON similar al siguiente.

{
"code": "0",
"message": "OK. Transaction successful.",
"payment": {
"authorizer_code": "000",
"authorizer_message": "Transacao OK",
"status": "CON",
"nit": "<NIT>",
"order_id": "13034649671",
"customer_receipt": "====CUPOM COMPRADOR====",
"merchant_receipt": "====CUPOM ESTABELECIMENTO====",
"authorizer_id": "410",
"acquirer_id": "1005",
"acquirer_name": "Redecard",
"authorizer_date": "28/02/2020T08:57",
"authorization_number": "132030",
"merchant_usn": "13034649671",
"esitef_usn": "170713097340300",
"sitef_usn": "132030",
"host_usn": "999132030",
"payment_date": "13/07/2017T15:52",
"amount": "1000",
"payment_type": "C",
"issuer": "2",
"authorizer_merchant_id": "<MERCHANT_ID>"
}
}

HTML de pago / autorización previa#

Para utilizar Samsung Pay con preautorización / pago HTML, comuníquese con un miembro de nuestro equipo de soporte para realizar la configuración necesaria. Es posible determinar qué banderas se aceptarán en Samsung Pay para la integración HTML.

Importante:

A diferencia de otras carteras digitales, el pago con Samsung Pay Node requerirá CVV en la confirmación. Dependerá del propietario de la tienda negociar con las redes adquirentes (Acquirers) para realizar pagos sin el requisito del código de seguridad;

Sin embargo, incluso si las Redes adquirentes permiten transacciones sin este código (CVV2), no hay garantía de que el Emisor (Institución Bancaria) acepte una transacción de esta manera (sin el código de seguridad).

Captura de autorización previa de REST y cancelación de REST / a través del portal#

El Samsung Pay No permite un mismo Reference ID ser utilizado más de una vez. Debido a esto, las operaciones de dos pasos como Pago / Cancelación, Autorización previa / Captura requieren que la tarjeta del pagador se almacene en Portal Carat. El almacenamiento a través de la interfaz HTML se puede realizar junto con el pago / preautorización siguiendo la documentación de Pago con almacenamiento en tarjeta oa través de la interfaz REST, como se describe en el capítulo siguiente.

Almacenamiento REST#

Es posible realizar el almacenamiento de la tarjeta utilizando el Reference ID de Samsung Pay. Póngase en contacto con nuestro equipo de soporte para realizar las configuraciones necesarias para habilitar este almacenamiento.

El almacenamiento de tarjetas REST funciona como si fuera a almacenar cualquier tarjeta, pero con las siguientes precauciones:

  • En lugar de enviar el número de tarjeta, envíe el campo wallet_transaction_id con el contenido de la Reference ID.
  • enviando el campo authorizer_id debe ser '410' (Samsung Pay).

Para obtener más detalles, consulte [aquí].(armazenamento-rest-fluxo.md).