- Directives d'intégration
- Fonctionnalités prises en charge (Modes de paiement)
- Paiements mobiles
- Paiements par Samsung Pay
Samsung Pay
Samsung Pay est un service de paiement mobile et de portefeuille numérique fourni par Samsung Electronics qui permet aux payeurs d'effectuer des paiements à l'aide d'appareils Samsung pris en charge. Samsung Pay est un paiement mobile pris en charge sur Mastercard Gateway.
Cette page explique les détails de l'intégration spécifique à Samsung Pay. Nous vous recommandons de lire les directives d'intégration pour les paiements mobiles avant de créer une intégration Samsung Pay.
Conditions préalables
Pour accepter les paiements par Samsung Pay :
- Vous devez vous inscrire auprès de Samsung.
- Votre your payment service provider doit activer les paiements mobiles pour votre profil de commerçant sur la passerelle.
Ajout de la prise en charge de Samsung Pay à votre intégration
Vous pouvez intégrer Samsung Pay sur votre application mobile à l'aide de Direct Payment.
- Lors de la confirmation du paiement, vous soumettez le jeton de paiement crypté retourné par Samsung Pay à votre serveur.
- Décryptez le jeton de paiement sur votre serveur en utilisant votre clé privée. Pour les étapes de décryptage, contactez Samsung.
- Renseignez les champs de transaction correspondants sur la demande Authorize/Pay (Autoriser/Payer) ou Update Session (Mettre à jour la session) avec les clés du jeton décrypté.
Clé JSON Samsung PayChamp de demande d'API correspondantDescriptiontokenPAN sourceOfFunds.provided.card.number Numéro de compte principal spécifique à l'appareil. tokenPanExpiration sourceOfFunds.provided.card.expiry.month
sourceOfFunds.provided.card.expiry.yearDate d'expiration de tokenPAN. method sourceOfFunds.provided.card.devicePayment.
cryptogramFormatFormat du cryptogramme. Définissez ce champ avec la valeur 3DSECURE. cryptogram sourceOfFunds.provided.card.devicePayment.
onlinePaymentCryptogramCryptogramme au format 3DSecure. eci_indicator sourceOfFunds.provided.card.devicePayment.
eciIndicatorIndicateur ECI par spécification 3DSecure. currency_code order.currency Code devise ISO 4217 pour la transaction. amount order.amount Montant de la commande. - Outre les champs ci-dessus, incluez ceux-ci dans la demande Authorize/Pay (Autoriser/Payer) et soumettez-la à la passerelle.
- transaction.source=INTERNET
- order.walletProvider=SAMSUNG_PAY
- device.mobilePhoneModel : (facultatif) identifiant de l'appareil mobile utilisé pour initier le paiement.
- posTerminal.location : vous pouvez spécifier
PAYER_TERMINAL_OFF_PREMISESouPAYER_TERMINAL_ON_PREMISES. Si vous n'indiquez pas de valeur, la valeurPAYER_TERMINAL_OFF_PREMISESest utilisée.
Exemple de demande
L'exemple ci-dessous présente une demande Authorization (Autorisation) dans REST, où le jeton de paiement est décrypté par la passerelle.
| URL | 'https://test-gateway.mastercard.com/api/rest/version/71/merchant/MADA_DMS_AU/order/446974188/transaction/746444836' |
| Méthode HTTP | PUT |
| En-tête | 'Autorisation : 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"
}
}'
Exemple de réponse
{
"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"
}
Test de l'intégration Samsung Pay
Vous pouvez tester votre intégration avec la passerelle en environnement de production à l'aide de votre profil de commerçant de test et un DPAN ou un FPAN pris en charge.
Si vous testez un paiement mobile, utilisez l'un des DPAN ou FPAN pris en charge indiqués dans le tableau ci-dessous.
Système |
DPAN ou FPAN |
Date d'expiration |
|---|---|---|
| Mastercard | 5123456789012346 | 01/2039 |
| American Express | 340353278080900 | 01/2039 |
| Visa | 4440000009900010 | 01/2039 |