A Payment Program Enablement is a resource created when a Partner activates an optional Payment Program in addition to the preset Payment Programs available for their account. This resource defines which Payment Program is being enabled and the criteria under which it applies.
A Payment Program Enablement determines which optional or restricted Payment Programs are activated for a Partner and available for use in accordance with their Payment Program Plan.
Overview
A Payment Program Enablement represents the activation of a specific Payment Program for a Partner. Partners create enablements to activate optional Payment Programs.
Optional enablements become active immediately once created through the Management API. Preset Payment Programs are automatically available and do not require enablements.
Relationships and dependencies
A Payment Program Enablement interacts with the following resources:
- Partner Product – identifies the Partner for whom the enablement is created.
- Payment Program – identifies the Payment Program being activated.
- Payment Program Plan – defines which Payment Programs are eligible based on configuration such as MCC and customer country.
Resource properties
The Payment Program Enablement resource contains attributes required to activate a Payment Program, including the Payment Program identifier, and criteria such as customer country or merchant category codes.
/v2/accounts/{partner_account_id}/products/payment/payment-programs/payment-program-enablements| Parameter | Required | Description |
|---|---|---|
partner_account_id | Yes | Unique identifier assigned by Klarna to the onboarded partner. |
Identifier requirements:
partner_account_id— identifies the Partner creating the enablement.payment_program_id— identifies the Payment Program to be enabled.
Lifecycle
Payment Programs may be preset, optional, or restricted. Enablement behavior depends on the enablement type of the Payment Program.
| Enablement type | Definition |
|---|---|
| Enabled automatically by Klarna and cannot be disabled by the Partner. |
| Can be enabled or disabled by the Partner using the API. |
| Requires Klarna approval before activation. |
The lifecycle of a Payment Program Enablement:
- Creating an enablement activates an optional Payment Program immediately.
- Deleting an enablement disables an optional Payment Program for future processing.
- Restricted enablements activate only after Klarna manually approves them.
- Preset Payment Programs never require enablements.
Webhooks: Payment Program Enablements do not emit webhook events.
Example use cases
List Payment Program enablements
Use the listPaymentProgramEnablements operation to retrieve all current, future, and historical enablements for a Partner Account ID.
Create a Payment Program enablement
Use the createPaymentProgramEnablement operation to activate an optional Payment Program.
For example, a Partner can enable an optional Payment Program for a specific customer country by including the required country code in the create request.
Delete a Payment Program enablement
Use the deletePaymentProgramEnablement operation to disable an optional Payment Program.
Enablement removals are processed immediately by Klarna systems.
API operations
The following API operations are available: