Spend (Unknown Customer PSD2)
Learn how to enable spending for an unknown customer. This is PSD2 compliant journey.
SSO Widget - Log in
Authenticate customer to retrieve their log in token to continue the spend journey. The widget will return a token which will be used in the Customer Journey API and later in spend SCA widget.
The token is used to retrieve the account status, credit limit and balances of the customer using the GetCustomerJourneyDetailsUsingToken endpoint. This enables check on the customer account status and eligibility to spend prior to starting the spend journey.
retrieveSpendOptionsForCustomerRef
This endpoint is optional and only applicable If you have multiple spend plans such as instalments. Calling this endpoint with the basket value will return the eligible plans for the customer in the specified order.
initiate
This endpoint is only required for PSD2 journeys. It allows you to check if the transaction requires a PSD2 step-up. If it does not, it returns a transaction-exempt token. It also allows for merchant overriding of an exemption. The endpoint will return the SCA widget URL.
SCA Widget
This widget is only required for PSD2 journeys. It is hosted as an iframe that enables the initiation, re-issue, and entry of SMS OTPs. It returns the end result of the OTP journey back to the parent frame. Passing the OTP validation will result in an upgraded authorisation token being passed to the parent frame for use within the authorise endpoint.
authorise
Authorise a transaction once a spend option has been chosen by completing the required fields for the endpoint. Some fields may have been provided as part of previous responses in the journey, e.g. spend option (optional, defaults to revolving credit if not provided) and PSD2 authorisation token.
settle
Settle the authorisation once the order has been received using the authorisation ID passed from the previous endpoint.
Request Example
Request
HTML
1<iframe src="https://id.newdaytechnology.com/newpay/login?sessionId=f925a9d8-53b5-47bd-854e-a9f31e7aa299&redirect_uri="https://pay.deko.finance"></iframe>Response Example
Response
JSON
1{
2 "hashedUserId": "n5XU5zccSSMVSDlqAiQEqWYgq4pVAzr6AkT9Je8rj7k=",
3 "identityToken": "eyJhbGciOiJSUzI1NiIsImtpZCI6Ijg2QjdERjk1Q0VBRDJBNzAyMzJBMjUxRTY4MjZGODJFREZCMEVGNzUiLCJ4NXQiOiJocmZmbGM2dEtuQWpLaVVlYUNiNEx0LXc3M1UiLCJ0eXAiOiJhdCtqd3QifQ.eyJpc3MiOiJodHRwczovL2lkcC1hMDYuc3RnLW5ld2RheXRlY2hub2xvZ3kubmV0IiwibmJmIjoxNzE4MzU3ODc4LCJpYXQiOjE3MTgzNTc4NzgsImV4cCI6MTcxODM1OTY3OCwiYXVkIjpbIlpOMVAyRTlWOENWS0c1M0Y5SU5DUUMyNzRHWU1ZMlo5LUFQSSIsImh0dHBzOi8vaWRwLWEwNi5zdGctbmV3ZGF5dGVjaG5vbG9neS5uZXQvcmVzb3VyY2VzIl0sInNjb3BlIjpbIm9wZW5pZCIsInNzbyIsIlpOMVAyRTlWOENWS0c1M0Y5SU5DUUMyNzRHWU1ZMlo5LVNDT1BFIiwib2ZmbGluZV9hY2Nlc3MiXSwiYW1yIjpbInBpbiJdLCJjbGllbnRfaWQiOiIyRjNEMzI3MkVBOEU0Q0Q5OTY2MzRFQjlGMkYxNEY5MiIsInN1YiI6Im41WFU1emNjU1NNVlNEbHFBaVFFcVdZZ3E0cFZBenI2QWtUOUplOHJqN2s9IiwiYXV0aF90aW1lIjoxNzE4MzU3ODc4LCJpZHAiOiJsb2NhbCIsImF1dGhfbGV2ZWwiOiJub25lIiwiZGF0YV9jb3JyZWxhdGlvbl9pZCI6InRlc3QifQ.wV9Inl4x3Y96qohkajl5IXgyeYY-R1ibG3oMpSQDNEl3nd9GCfI18y3Kw_GzmHzabiRsHTRJyDPKbUlnVqFgNBcnPmW4nlvvBkZ4BcYTts1h68Q5S2AzNFeopODKWVAtlSAmyDWzoE4xZctY3by3ToTaQrPu2_xa0Z3kOsRljRdZ3v1NJ0v_OTcYevMxrBUQmWUWBEp_Sd_Gd8yamPU1A6WpKXCfgjZ97KKmGIA87RKkFWsaQj2RzOdoksnhqk3vEGP-J1qHPKEQgpL3eG1CR59_cPtrihoGl0vH9Q-fyTJFOemtWVxP_UU2LUoU35cB4Os90APtiemQc1ZASKbFcw",
4 "expiresIn": 1800,
5 "tokenType": "Bearer",
6 "refreshToken": "059A03A97ACE893989DDE289790642D69C319075964F1CC35E5DB8A98107DBA5-1",
7 "correlationId": "f925a9d8-53b5-47bd-854e-a9f31e7aa299",
8 "success": true
9}