A Payment program plan acts as the matrix that maps MCC and consumer country combinations to the Payment programs available for those transactions. Each Acquiring Partner has one Payment program plan. Partners cannot modify the plan, but they can enable discretionary Payment programs when the plan allows it and the enablement criteria are met.

A Payment program plan is associated with the following resources:

• Payment Profile – defines the configuration used when evaluating transactions.
• Price Plan – defines the pricing structure applied to Payment transactions.
• Payment Program – the commercial category used for settlement.
• Payment Program Enablement – created by a Partner to enable discretionary Payment programs when allowed by the plan.
• Payment Transactions – evaluated against the plan to determine the applicable Payment programs.

A Payment program plan includes the following properties:

Use the listPaymentProgramPlans operation to retrieve all versions of the Payment program plan assigned to your Acquiring Partner.

Payment Programs

GET:/v2/distribution/products/payment/payment-program-plans

Response Body

Show recommended

Parameter	Required	Description

Here you can find all required parameters for this operation listPaymentProgramPlans

Klarna creates and maintains all Payment program plans. Partners can only read plan versions.

• Klarna releases a new version only for breaking changes.
• Each version defines its own effective_from and effective_to dates.
• Partners are automatically migrated to the active version on its effective_from.
• Discretionary Payment programs are enabled through Payment Program Enablements, not by modifying the plan.

Use listPaymentProgramPlans to retrieve the full history of Payment program plan versions, including past, active, and upcoming versions.

After identifying the active plan version, use listPaymentProgramsForPaymentProgramPlan to retrieve all Payment programs included in that version.

Payment Programs

GET:/v2/distribution/products/payment/payment-program-plans/{payment_program_plan_id}

Path ParametersRequest HeadersResponse Body

Show recommended

Parameter	Required	Description
payment_program_plan_id	Yes	The identifier of the payment program plan.

Here you can find all required parameters for this operation listPaymentProgramsForPaymentProgramPlan

Use readPaymentProgram to retrieve attributes such as the display name and funding type.

Payment Programs

GET:/v2/distribution/products/payment/payment-programs/{payment_program_id}

Request HeadersResponse Body

Show recommended

Parameter	Required	Description

Here you can find all required parameters for this operation readPaymentProgram

• listPaymentProgramPlans
• listPaymentProgramsForPaymentProgramPlan
• readPaymentProgram