These are the APIs the partner server must call to integrate with S2P. All requests must be secured with Mutual SSL and must include the partner-id issued to the partner during onboarding.
Base URLs:
STG: https://s2p-api.stg.mpay.samsung.com/ext/v1
PRD: https://s2p-api.mpay.samsung.com/ext/v1
POST /registrations
Registers a new cardholder/member for the partner program.
Headers
Field
Validation
Description
Content-Type
Required
application/json
partner-id
Required
UUID identifying the partner, issued by Samsung during onboarding
request-id
Required
Unique identifier for this request, used for tracing/troubleshooting
InfoEach call to this endpoint generates a new welcomeUrl with a new expiration; the previous welcomeUrl is not invalidated.
Error Responses
HTTP Status
Error Code
Reason
400
400.1
Missing required header, the following parameter/s were not sentpartner-idrequest-id
400
Invalid header valuepartner-id does not match a known/active partner
410
Gone – no registration exists for the given regId
500
Unexpected internal error
503
Backing datastore temporarily unavailable — safe to retry
Outbound Notifications (S2P ➡️ Partner)
This is the API the partner must build and host. S2P calls this endpoint on the partner’s server to notify about provisioning events and to request encrypted card data during provisioning.
Base URL: Provided by the partner during onboarding (staging and production URLs configured separately).
Path: POST /notifications - path is agreed with the partner during onboarding; adjust to match what was registered
Security: Mutual SSL required. S2P connects using a client certificate signed by the partner's own CA — the partner must issue this certificate to Samsung and be able to validate it on inbound connections.
Headers Sent by S2P
Field
Validation
Description
Content-Type
Required
application/json
Accept
Required
Application/json
partner-id
Required
Partner’s S2P-assigned identifier
request-id
Required
Unique identifier for this notification attempt
InfoAny additional custom headers configured for the partner during onboarding (e.g. an auth token/key) will also be included.
Request Body
Sent by S2P to the partner’s endpoint
Field
Type
Validation
Description
event.regId
UUID
Required
Registration ID this event relates to
event.type
Enum
Required
One of:WA_READYWA_PROVISIONEDWA_PROVISION_FAILURE
event.error
String
Conditional
Present on failure events. Only CARD_ALREADY_PRESENT is recognized as a specific error today; any other value is treated as a generic failure
user.id
String
Conditional
Samsung account ID. Present for Payment-type cards
emailMatches
Boolean
Optional
If the registration's email matches the Samsung account email
phoneMatches
Boolean
Optional
If the registration’s phone matches the device phone number
Synchronous – S2P blocks the wallet’s in-progress request waiting on the partner's response
The user has scanned the QR code and linked their Samsung Wallet app to the registration. The partner is expected to pre-provision the card with the issuer and return the encrypted card data (card.data.encryptedData) in the response.
WA_PROVISIONED
Asynchronous, best-effort
The card/token was successfully added to the wallet
WA_PROVISION_FAILURE
Asynchronous, best-effort
Provisioning failed for an unknown reason
WA_PROVISION_FAILURE
CARD_ALREADY_PRESENT
Asynchronous, best-effort
Provisioning failed because the card is already present in the wallet
Response – 200 OK
Field
Type
Validation
Description
card.data.encryptedData
String
Conditional
Encrypted PAN/card data (issuer blob) to provision the card. Required for WA_READY notifications on Payment-type cards — S2P will fail the in-progress provisioning flow if this isn't returned. Not required for WA_PROVISIONED/WA_PROVISION_FAILURE (response body is ignored for these; only the HTTP status matters)
We use cookies to improve your experience on our website and to show you relevant
advertising. Manage you settings for our cookies below.
Essential Cookies
These cookies are essential as they enable you to move around the website. This
category cannot be disabled.
Company
Domain
Samsung Electronics
developer.samsung.com, .samsung.com
Analytical/Performance Cookies
These cookies collect information about how you use our website. for example which
pages you visit most often. All information these cookies collect is used to improve
how the website works.
Company
Domain
Samsung Electronics
.samsung.com
Functionality Cookies
These cookies allow our website to remember choices you make (such as your user name, language or the region your are in) and
tailor the website to provide enhanced features and content for you.
Company
Domain
Samsung Electronics
developer.samsung.com, google.account.samsung.com
Preferences Submitted
You have successfully updated your cookie preferences.