- Pautas de integración
- Características soportadas (métodos de pago)
- Pagos con dispositivo
- Pagos con Samsung Pay
Samsung Pay
Samsung Pay es un servicio de pago móvil y billetera digital de Samsung Electronics que permite que los pagadores realicen pagos con dispositivos Samsung compatibles. Samsung Pay es un pago con dispositivo compatible en el American Express Payment Gateway.
Esta página describe los detalles de la integración específicos de Samsung Pay. Se recomienda que lea las pautas de integración para los pagos con dispositivo, antes de crear su integración de Samsung Pay.
Prerrequisitos
Para aceptar pagos con Samsung Pay:
- Debe registrarse con Samsung.
- your payment service provider debe habilitar su perfil del negocio para pagos con dispositivo en el motor de pagos.
Agregar soporte para Samsung Pay a su integración
Puede integrar Samsung Pay en su aplicación móvil con Web-Services API.
- En la confirmación de pago, envíe el token de pago cifrado devuelto por Samsung Pay a su servidor.
- Descifre el token de pago en su servidor con su clave privada. Para conocer los pasos de descifrado, póngase en contacto con Samsung.
- Proporcione las claves del token descifrado en los campos de transacción correspondientes, en la solicitud Authorize/Pay o en la solicitud Update Session.
Clave JSON de Samsung PayCampo de solicitud de API correspondienteDescripcióntokenPAN sourceOfFunds.provided.card.number El número de cuenta primario específico del dispositivo. tokenPanExpiration sourceOfFunds.provided.card.expiry.month
sourceOfFunds.provided.card.expiry.yearLa fecha de vencimiento del tokenPAN. method sourceOfFunds.provided.card.devicePayment.
cryptogramFormatEl formato del criptograma. Configure esto en 3DSECURE. cryptogram sourceOfFunds.provided.card.devicePayment.
onlinePaymentCryptogramCriptograma en formato 3DSecure. eci_indicator sourceOfFunds.provided.card.devicePayment.
eciIndicatorIndicador ECI según la especificación 3DSecure. currency_code order.currency El código de moneda ISO 4217 para la transacción. amount order.amount El monto del pedido. - Además de los campos anteriores, incluya estos en la solicitud Authorize/Pay y envíelos al motor de pagos.
- transaction.source=INTERNET
- order.walletProvider=SAMSUNG_PAY
- device.mobilePhoneModel: (opcional) el identificador del dispositivo móvil utilizado para iniciar el pago.
- posTerminal.location: puede especificar
PAYER_TERMINAL_OFF_PREMISESoPAYER_TERMINAL_ON_PREMISES. Si no proporciona un valor, se utilizaPAYER_TERMINAL_OFF_PREMISES:
Solicitud de ejemplo
Aquí hay una solicitud de autorización de muestra en REST, donde el motor de pagos descifra el token de pago.
| URL | 'https://gateway-emea.americanexpress.com/api/rest/version/71/merchant/MADA_DMS_AU/order/446974188/transaction/746444836' |
| Método HTTP | PUT |
| Encabezado | 'Authorization: bWVyY2hhbnQuTUFEQV9ETVNfQVU6M2RjYTQ2YTU1ODYwNDlmMjhhM2FmZGJmZDEwMGNmNWQ=' |
'{
"apiOperation": "AUTHORIZE",
"order": {
"amount": "1500",
"currency": "JPY",
"walletProvider": "SAMSUNG_PAY"
},
"sourceOfFunds": {
"provided": {
"card": {
"number": "5123450000000008",
"expiry": {
"month": "01",
"year": "39"
},
"devicePayment": {
"cryptogramFormat": "3DSECURE",
"onlinePaymentCryptogram": "AAAAAAAALJI6DbfqRzUcwAC6gAAGhgEDoLABAAhAgAABAAAAMlkUxA==",
"eciIndicator": "20"
}
}
},
"type": "CARD"
},
"device": {
"ani": "12341234"
},
"transaction": {
"source": "INTERNET"
}
}'
Respuesta de ejemplo
{
"authorizationResponse": {
"commercialCard": "123",
"commercialCardIndicator": "1",
"date": "0314",
"financialNetworkCode": "MCC",
"posData": "1025104006600",
"posEntryMode": "812",
"processingCode": "003000",
"responseCode": "00",
"stan": "47497",
"time": "105733",
"transactionIdentifier": "609405631",
"transactionIntegrityClass": "A1"
},
"device": {
"ani": "12341234"
},
"gatewayEntryPoint": "WEB_SERVICES_API",
"merchant": "MADA_DMS_AU",
"order": {
"amount": 1500,
"authenticationStatus": "AUTHENTICATION_NOT_IN_EFFECT",
"certainty": "FINAL",
"chargeback": {
"amount": 0,
"currency": "JPY"
},
"creationTime": "2023-03-14T10:57:33.175Z",
"currency": "JPY",
"id": "446974188",
"lastUpdatedTime": "2023-03-14T10:57:33.554Z",
"merchantAmount": 1500,
"merchantCategoryCode": "1234",
"merchantCurrency": "JPY",
"status": "AUTHORIZED",
"totalAuthorizedAmount": 1500,
"totalCapturedAmount": 0,
"totalDisbursedAmount": 0,
"totalRefundedAmount": 0,
"walletProvider": "SAMSUNG_PAY"
},
"response": {
"acquirerCode": "00",
"acquirerMessage": "Approved",
"gatewayCode": "APPROVED",
"gatewayRecommendation": "NO_ACTION"
},
"result": "SUCCESS",
"sourceOfFunds": {
"provided": {
"card": {
"brand": "MASTERCARD",
"devicePayment": {
"cryptogramFormat": "3DSECURE"
},
"deviceSpecificExpiry": {
"month": "1",
"year": "39"
},
"deviceSpecificNumber": "512345xxxxxx0008",
"fundingMethod": "UNKNOWN",
"number": "xxxxxxxxxxxxxxxx",
"scheme": "MASTERCARD",
"storedOnFile": "NOT_STORED"
}
},
"type": "CARD"
},
"timeOfLastUpdate": "2023-03-14T10:57:33.554Z",
"timeOfRecord": "2023-03-14T10:57:33.263Z",
"transaction": {
"acquirer": {
"batch": 20230314,
"date": "0314",
"id": "SYSTEST_ACQ_S2I",
"merchantId": "12345678",
"transactionId": "609405631"
},
"amount": 1500,
"authenticationStatus": "AUTHENTICATION_NOT_IN_EFFECT",
"authorizationCode": "112233",
"currency": "JPY",
"id": "746444836",
"receipt": "307310047497",
"source": "INTERNET",
"stan": "47497",
"terminal": "1111",
"type": "AUTHORIZATION"
},
"version": "71"
}
Prueba de integración de Samsung Pay
Puede probar su integración con el motor de pagos en producción usando su perfil de pruebas del negocio y un DPAN o FPAN admitidos.
Si está probando un dispositivo o pago con tarjeta, use un DPAN o FPAN admitido de la siguiente tabla.
Esquema |
DPAN o FPAN |
Fecha de vencimiento |
|---|---|---|
| Mastercard | 5123456789012346 | 01/2039 |
| American Express | 340353278080900 | 01/2039 |
| Visa | 4440000009900010 | 01/2039 |