- Ghid de integrare
- Caracteristici acceptate (Metode de plată)
- Plăți dispozitive
- Plățile Samsung Pay
Samsung Pay
Samsung Pay este un serviciu de plăți mobile și portofel digital creat de Samsung Electronics, care permite plătitorilor să efectueze plăți cu dispozitivele Samsung acceptate. Samsung Pay este o metodă de plată prin dispozitiv acceptată în American Express Payment Gateway.
Această pagină descrie detaliile integrării specifice metodei Samsung Pay. Este recomandat să citiți ghidul de integrare pentru plățile prin dispozitiv înainte de a crea o integrare Samsung Pay.
Cerințe preliminare
Pentru a accepta plățile Samsung Pay:
- Trebuie să vă înscrieți la Samsung.
- Profilul dvs. de comerciant de pe gateway trebuie să aibă opțiunea Plăți dispozitiv activată de către your payment service provider.
Adăugarea compatibilității cu Samsung Pay în integrarea dvs.
Puteți integra Samsung Pay în aplicația dvs. mobilă utilizând Web-Services API.
- La confirmarea plății, trimiteți simbolul criptat al plății returnat de Samsung Pay către serverul dvs.
- Decriptați simbolul plății pe serverul dvs. folosindu-vă cheia privată. Pentru etapele decriptării, contactați Samsung.
- Introduceți cheile din simbolul decriptat în câmpurile corespunzătoare ale tranzacției din solicitarea Authorize/Pay sau solicitarea Update Session.
Cheie JSON Samsung PayCâmp corespunzător solicitare APIDescrieretokenPAN sourceOfFunds.provided.card.number Numărul de cont principal specific dispozitivului. tokenPanExpiration sourceOfFunds.provided.card.expiry.month
sourceOfFunds.provided.card.expiry.yearData de expirare a tokenPAN. method sourceOfFunds.provided.card.devicePayment.
cryptogramFormatFormatul criptogramei. Setați acest câmp la 3DSECURE. cryptogram sourceOfFunds.provided.card.devicePayment.
onlinePaymentCryptogramCriptogramă în format 3-D Secure. eci_indicator sourceOfFunds.provided.card.devicePayment.
eciIndicatorIndicatorul ECI conform specificațiilor 3-D Secure. currency_code order.currency Codul ISO 4217 al monedei utilizate pentru tranzacție. amount order.amount Valoarea comenzii. - În plus față de câmpurile de mai sus, includeți următoarele în solicitarea Authorize/Pay și trimiteți-o către gateway.
- transaction.source=INTERNET
- order.walletProvider=SAMSUNG_PAY
- device.mobilePhoneModel: (opțional) Identificatorul dispozitivului mobil utilizat pentru inițierea plății.
- posTerminal.location: Puteți specifica
PAYER_TERMINAL_OFF_PREMISESsauPAYER_TERMINAL_ON_PREMISES. Dacă nu furnizați o valoare, se va utiliza valoareaPAYER_TERMINAL_OFF_PREMISES.
Exemplu de solicitare
Iată un exemplu de solicitare de autorizare în REST în care simbolul plății este decriptat de către gateway.
| URL | 'https://gateway-emea.americanexpress.com/api/rest/version/71/merchant/MADA_DMS_AU/order/446974188/transaction/746444836' |
| Metoda HTTP | PUT |
| Antet | '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"
}
}'
Exemplu de răspuns
{
"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"
}
Testarea integrării Samsung Pay
Puteți testa integrarea pe gateway în modul de lucru, folosindu-vă profilul de testare comerciant și un DPAN sau FPAN acceptat.
Dacă testați o plată cu un dispozitiv sau un card, utilizați un DPAN sau FPAN acceptat din tabelul următor.
Schemă |
DPAN sau FPAN |
Dată de expirare |
|---|---|---|
| Mastercard | 5123456789012346 | 01/2039 |
| American Express | 340353278080900 | 01/2039 |
| Visa | 4440000009900010 | 01/2039 |