Manage Klarna Payment Products seamlessly by understanding their lifecycle stages, onboarding process, and enabling or disabling options for security and efficiency.
Payment Products within the Partner Accounts follow a specific lifecycle, ensuring they are managed efficiently from inception to discontinuation. Familiarize yourself with these processes and actively use the available tools to optimize account actions and product handling.
The lifecycle diagram below provides detailed insight into these stages:
| Status | Definition |
|---|---|
| The product is capable of processing new payment requests. |
| The product cannot process new payment requests. It can be reverted if you are the one that disabled it. Other actions, such as post-purchase calls, may still succeed. |
| The payment product is fully disabled by Klarna for AML, fraud or risk reasons. |
Account termination can only be triggered by Klarna. The Acquiring Partner can however decide to disable or enable a payment product on a partner account using the following API endpoints:
Klarna may disable an account based on fraud or other unsavory behavior. More information on this process can be found in the Account lifecycle webhooks section.
Klarna relies on Acquiring Partners to safeguard the reliability and security of the Klarna Network. If a Partner account has only one Payment Product configured and it is disabled, the account will be unable to process transactions, but may continue to manage completed payments.
In case the Partner is suspended by the Acquiring Partner or instead decides to close their account, the Acquiring Partner must immediately disable all products configured on the account so Klarna has an accurate understanding of the Partner status. Updates to the product configuration should reflect changes applied in the Acquiring Partner systems, and should not be triggered more than once per account per second where possible. Any update or disabling of a product may take up to 10 minutes to be reflected towards customers.
Depending on the status of a Partner when their Klarna products are disabled, Klarna may continue to receive outreach from customers for months after the disablement action. Ensuring accurate and up to date account and product status towards Klarna will allow higher accuracy on adjudication of customer claims and other outreaches.
To disable the payment product on a given partner Account, the Acquiring Partner must use the Suspend a Payment ProductAPI endpoint and indicate the reason why the payment product is being disabled:
| Reason | Definition |
|---|---|
| In case Klarna Product is being disabled due to fraud suspicion. More information on fraud and account security is available in Payments on restricted businesses. |
| In case the Klarna Productis being disabled due to voluntary cancellation of the account |
An open text details field is also available for more information about why the payment product is being disabled.
Additional enums will be added in a future release.
To re-enable a disabled payment—whether due to a misidentified fraud case or the Partner choosing to restore their integration, the Acquiring Partner must use the Enable a Payment ProductAPI endpoint.