Next actions

Learn how to handle next actions for different payment methods.

3D Secure card payments

Yorlet supports 3D Secure to comply with the Strong Customer Authentication regulation. Your integration should support 3D Secure for all card payments as the issuing bank will decide whether authentication is required or not.

Handle manually

You need to pass a return_url when you confirm a Transaction on the server. If the payment requires additional authentication the status will transition to requires_action and you should inspect the next_action object for the next step.

next_action: {
redirect_to_url: {
url: '{{URL_TO_REDIRECT_TO}}',
return_url: '{{RETURN_URL}}'
},
type: 'redirect_to_url'
}

Redirect to url

Redirect your customer to the next_action.redirect_to_url.url. After the customer completes the authentication flow they will be redirected back to your supplied return_url, which will include the transaction ID in the transaction URL query parameter.

Alipay

next_action: {
alipay_redirect: {
url: '{{URL_TO_REDIRECT_TO}}',
return_url: '{{RETURN_URL}}'
},
type: 'alipay_redirect'
}