API & SDKsSupport

Klarna Partner Management API (v2/r5)

Download OpenAPI specification:Download

URL: https://www.klarna.com

next

Credentials

Management of own Account credentials.

Create a credential for your own account

Create a new credential

Securityklarna_api_key
Request
Request Body schema: application/json
required
description
string^[a-zA-Z0-9\-:;., _]{0,100}$

Description provided by the partner when creating a set of credentials

type
required
string

Indicates the type of credentials to be created. API for an api-key and CLIENT for a clientId which can be used by the Web SDK.

Enum: "CLIENT" "API"
environment
required
string

Indicates the environment (TEST or LIVE) for which the credentials should be created,

Enum: "LIVE" "TEST"
Responses
200

Credential created

400

Bad Request, there was an error in the input of the request. The request can not be retried without modifications.

401

Unauthorized, the request was not authorized.

404

Not Found, the requested resource was not found.

429

Too Many Requests, the request was rate limited.

500

Internal Server Error, there was an unexpected error in the API.

post/v2/account/credentials
Request samples
application/json
{
  • "description": "Test Client Credentials",
  • "type": "CLIENT",
  • "environment": "TEST"
}
Response samples
application/json
{
  • "credential_id": "376e67bb-8171-4dba-b330-9130dd0798e4",
  • "description": "Test Client Credentials",
  • "type": "CLIENT",
  • "environment": "TEST",
  • "client_id": "klarna_test_client_cADfmmYgMtpcgVi9toAaPXeCktHS2TKS7UrWxvxtWdCVq3uLpQXZVSPZNWEcLACDpvHZVmCWeFVD44fygezrVNU4ta9jdAR4H3evwjCKTTaRAs2sQDHSpN2TMzWVwrVpoZPacgTTVhXiWrNsXp23aEvdiLi"
}

List Credentials

List all credentials associated with the current account

Securityklarna_api_key
Responses
200

Credentials found

400

Bad Request, there was an error in the input of the request. The request can not be retried without modifications.

401

Unauthorized, the request was not authorized.

404

Not Found, the requested resource was not found.

429

Too Many Requests, the request was rate limited.

500

Internal Server Error, there was an unexpected error in the API.

get/v2/account/credentials
Request samples 
Response samples 
application/json
{
  • "credentials": [
    ]
}
Disable Credential
Disable a Credential.


Securityklarna_api_key 
Request 
path Parameters
credential_id
required
string <uuid>  (CredentialIdentifier) ([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}...
Identifier of the Credential


 
 Example:  206bbb83-9b6e-46fa-940d-337153c04a58
Responses 
204
No Content


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


delete/v2/account/credentials/{credential_id}
Request samples 
Response samples 
application/json
{
  • "error_id": "5a3f6b9c-9b3b-4b7e-8f9d-9b9a4b9a4b9a",
  • "error_type": "INPUT_ERROR",
  • "error_code": "INVALID_CONTENT_TYPE",
  • "error_message": "The received input is not valid JSON.\nUnterminated string at 19 [character 20 line 1].\n"
}
MTLS
Revokes mTLS certificate
Revoke mTLS certificate
The mTLS certificate that is being revoked cannot be the certificate that is currently being used to authenticate the request.
This will result in a 400 Bad Request response.


Securityklarna_api_key 
Request 
path Parameters
certificate_serial_number
required
string (MTLSCertificateSerialNumber)   <= 48 characters ^\w+$
Identifier of the MTLS Certificate


 
 Example:  2C8A1053F979D1E8C96A3A9357AE7D1E
Request Body schema: application/json
required
revoked_from
required
string <date-time>  (MTLSCertificateRevokedFrom) 
Date when the certificate expires


 
Responses 
200
MTLS certificate revoked


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


post/v2/account/mtls/{certificate_serial_number}/revoke
Request samples 
application/json
{
  • "revoked_from": "2021-12-31T23:59:59Z"
}
Response samples 
application/json
{
  • "serial_number": "2C8A1053F979D1E8C96A3A9357AE7D1E",
  • "revoked_from": "2021-12-31T23:59:59Z",
  • "status": "ACTIVE"
}
Payment Distribution Profiles
A Payment Distribution has a set of pre-defined profiles that can be used when handling Payment Products. An account onboarded to a Payment Product needs to have one Distribution Profile associated with it.


List all Payment Distribution profiles.
Fetches all payments distribution product profile, which can be selected to be used on a new Payment Product onboarding.


Securityklarna_api_key 
Responses 
200
Payment Distribution Profiles retrieved


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/distribution/products/payment/profiles
Request samples 
Response samples 
application/json
[
  • {
    }
]
Onboard
The onboard API allows the authenticated Account to create a fully functional account with associated business entity, product, websites etc.


Onboard a merchant
Onboard a new merchant. This request creates all necessary entries to have a fully functional account for the merchant.


Securityklarna_api_key 
Request 
Request Body schema: application/json
required
account_reference
required
string
Reference for the Distribution Partner in relation to the merchant being onboarded.


 
account_name
required
string
The name of the account, business name or similar.


 
required
object
The account owner details


 
account_group_reference
string
Partners can group several merchant accounts under given account_group_reference


 
account_group_id
string (AccountGroupIdentifier) 
Group id assigned by Klarna for a given account_group_reference. Partners can use this parameter as an alternative to account_group_reference to manage an account group.


 
required
Array of objects (PaymentProductData) 
Information about which products are being configured for this merchant


 
required
object (ChannelData) 
Root channel object


 
object (ExtraAccountData) 
Root extra account data object


 
Responses 
200
Merchant account created


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


Callbacks 
postWebhook callback
post/v2/distribution/onboard
Request samples 
application/json
{
  • "account_reference": "M123786123412",
  • "account_name": "John Doe Stakehouse",
  • "account_owner": {
    },
  • "products": [
    ],
  • "channel": {}
}
Response samples 
application/json
{
  • "account_id": "krn:partner:global:account:live:LWT2XJSE",
  • "account_reference": "M123786123412",
  • "account_name": "Merchant ABC US",
  • "state": "PARTIALLY_OPERATIONAL",
  • "state_reason": "INITIAL_SETUP"
}
Callback payload samples 
POST: Webhook callback
application/json
The webhook is triggered once the distribution partner's account state changes.


{
  • "metadata": {
    },
  • "payload": {
    }
}
Accounts
The Accounts API allows the authenticated Partner to create, read, manage the different Accounts it has access to.


Read Account
Read all details from a Account which the acting Account has read access on.
Optionally, include additional sub-resources in the response by using the expand query parameter. The expand parameter accepts a comma-separated list of supported sub-resource names. Each specified sub-resource will be included in the response if available. Maximum of 10 sub-resources can be expanded per request.


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
query Parameters
expand
Array of strings  <= 10 items 
A comma-separated list of sub-resources to include in the response. Maximum of 10 sub-resources can be expanded per request.


Items Enum: "products" "channel.collections" "channel.websites" "extra-account-data.account-information" "extra-account-data.business-information" "extra-account-data.beneficiary-information" "extra-account-data.settlement-information"  
Responses 
200
Account details


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/accounts/{account_id}
Request samples 
Response samples 
application/json
{
  • "account_id": "krn:partner:global:account:live:LWT2XJSE",
  • "account_reference": "M123786123412",
  • "account_name": "John Doe Stakehouse",
  • "account_group_reference": "all-john-doe-restaurants",
  • "account_group_id": "krn:partner:global:account:group:b0ac4fb5-2975-4417-ae76-f2ac86fb6c6d",
  • "account_owner": {
    },
  • "state": "OPERATIONAL",
  • "state_reason": "SETUP_COMPLETE"
}
Update Account
Update details from an Account which the acting Account has write access on.


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
Request Body schema: application/json
required
account_reference
string
Reference for the Distribution Partner in relation to the merchant being onboarded.


 
account_name
string
The name of the account, business name or similar.


 
object (AccountOwner) 
The account owner details


 
Array of objects (PaymentProductByIdUpdateData) 
Information about which products are being updated.


 
object (ChannelDataUpdate) 
Channels


 
object (ExtraAccountData) 
Root extra account data object


 
Responses 
200
Account details


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


patch/v2/accounts/{account_id}
Request samples 
application/json
{
  • "account_reference": "M123786123412",
  • "account_name": "John Doe Stakehouse",
  • "account_owner": {
    }
}
Response samples 
application/json
{
  • "account_id": "krn:partner:global:account:live:LWT2XJSE",
  • "account_reference": "M123786123412",
  • "account_name": "John Doe Stakehouse",
  • "account_group_reference": "all-john-doe-restaurants",
  • "account_group_id": "krn:partner:global:account:group:b0ac4fb5-2975-4417-ae76-f2ac86fb6c6d",
  • "account_owner": {
    },
  • "state": "PARTIALLY_OPERATIONAL",
  • "state_reason": "ACCOUNT_UPDATE"
}
Payment Products
The Accounts API allows the authenticated Partner to create, read, manage the Payment Products on an Account.


Get all account payment products
Obtains a list of all payment products associated with the account


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
Responses 
200
List of payment products


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/accounts/{account_id}/products/payment
Request samples 
Response samples 
application/json
[
  • {
    }
]
Patch a given Payment Product information
Update information from a given payment product associated with the account.


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
required
PaymentProductDefault (string) or PaymentProductIdentifier (string)
Identifier of the Payment Product the action is done on behalf of. Use default to apply the action on the unique payment product.


 
Request Body schema: application/json
required
merchant_category_code
string (merchant-category.model_MerchantCategoryCode) 
The Merchant Category Code (MCC) is a four-digit number that is used to classify the type of goods or services
offered by a business.
[Read more here (https://docs.klarna.com/klarna-network-distribution/manage-partners/merchant-category-code)


 Enum: "0742" "0743" "0744" "0763" "0780" "1520" "1711" "1731" "1740" "1750" "1761" "1771" "1799" "2741" "2791" "2842" "3000" "3001" "3002" "3003" "3004" "3005" "3006" "3007" "3008" "3009" "3010" "3011" "3012" "3013" "3014" "3015" "3016" "3017" "3018" "3019" "3020" "3021" "3022" "3023" "3024" "3025" "3026" "3027" "3028" "3029" "3030" "3031" "3032" "3033" "3034" "3035" "3036" "3037" "3038" "3039" "3040" "3041" "3042" "3043" "3044" "3045" "3046" "3047" "3048" "3049" "3050" "3051" "3052" "3053" "3054" "3055" "3056" "3057" "3058" "3059" "3060" "3061" "3062" "3063" "3064" "3065" "3066" "3067" "3068" "3069" "3070" "3071" "3072" "3075" "3076" "3077" "3078" "3079" "3080" "3081" "3082" "3083" "3084" "3085" "3086" "3087" "3088" "3089" "3090" "3094" "3096" "3097" "3098" "3099" "3100" "3102" "3103" "3106" "3110" "3111" "3112" "3115" "3117" "3118" "3125" "3126" "3127" "3129" "3130" "3131" "3132" "3133" "3135" "3136" "3137" "3138" "3143" "3144" "3145" "3146" "3148" "3151" "3154" "3156" "3159" "3161" "3164" "3165" "3167" "3170" "3171" "3172" "3174" "3175" "3176" "3177" "3178" "3180" "3181" "3182" "3183" "3184" "3185" "3186" "3187" "3188" "3190" "3191" "3193" "3196" "3197" "3200" "3203" "3204" "3206" "3211" "3212" "3213" "3215" "3216" "3217" "3218" "3219" "3220" "3221" "3222" "3223" "3226" "3228" "3229" "3231" "3233" "3234" "3235" "3236" "3238" "3239" "3240" "3241" "3242" "3243" "3245" "3246" "3247" "3248" "3251" "3252" "3253" "3254" "3256" "3259" "3260" "3261" "3262" "3263" "3266" "3267" "3280" "3282" "3284" "3285" "3286" "3287" "3292" "3293" "3294" "3295" "3296" "3297" "3298" "3299" "3300" "3301" "3302" "3303" "3308" "3351" "3352" "3353" "3354" "3355" "3357" "3359" "3360" "3361" "3362" "3364" "3366" "3368" "3370" "3374" "3376" "3380" "3381" "3385" "3386" "3387" "3388" "3389" "3390" "3391" "3393" "3394" "3395" "3396" "3398" "3400" "3405" "3409" "3414" "3420" "3421" "3423" "3425" "3427" "3428" "3429" "3430" "3431" "3432" "3433" "3434" "3435" "3436" "3437" "3438" "3439" "3441" "3501" "3502" "3503" "3504" "3505" "3506" "3507" "3508" "3509" "3510" "3511" "3512" "3513" "3514" "3515" "3516" "3517" "3518" "3519" "3520" "3521" "3522" "3523" "3524" "3525" "3526" "3527" "3528" "3529" "3530" "3531" "3532" "3533" "3534" "3535" "3536" "3537" "3538" "3539" "3540" "3541" "3542" "3543" "3544" "3545" "3546" "3547" "3548" "3549" "3550" "3551" "3552" "3553" "3554" "3555" "3556" "3557" "3558" "3559" "3560" "3561" "3562" "3563" "3564" "3565" "3566" "3567" "3568" "3569" "3570" "3571" "3572" "3573" "3574" "3575" "3576" "3577" "3578" "3579" "3580" "3581" "3582" "3583" "3584" "3585" "3586" "3587" "3588" "3589" "3590" "3591" "3592" "3593" "3594" "3595" "3596" "3597" "3598" "3599" "3600" "3601" "3602" "3603" "3604" "3607" "3608" "3609" "3612" "3613" "3614" "3615" "3617" "3618" "3619" "3620" "3621" "3622" "3623" "3624" "3625" "3626" "3627" "3628" "3629" "3630" "3631" "3632" "3633" "3634" "3635" "3636" "3637" "3638" "3639" "3640" "3641" "3642" "3643" "3644" "3645" "3646" "3647" "3648" "3649" "3650" "3651" "3652" "3653" "3654" "3655" "3656" "3657" "3658" "3659" "3660" "3661" "3662" "3663" "3664" "3665" "3666" "3667" "3668" "3669" "3670" "3671" "3672" "3673" "3674" "3675" "3676" "3677" "3678" "3679" "3680" "3681" "3682" "3683" "3684" "3685" "3686" "3687" "3688" "3689" "3690" "3691" "3692" "3693" "3694" "3695" "3696" "3697" "3698" "3699" "3700" "3701" "3702" "3703" "3704" "3705" "3706" "3707" "3708" "3709" "3710" "3711" "3712" "3713" "3714" "3715" "3716" "3717" "3718" "3719" "3720" "3721" "3722" "3723" "3724" "3725" "3726" "3727" "3728" "3729" "3730" "3731" "3732" "3733" "3734" "3735" "3736" "3737" "3738" "3739" "3740" "3741" "3742" "3743" "3744" "3745" "3746" "3747" "3748" "3749" "3750" "3751" "3752" "3753" "3754" "3755" "3756" "3757" "3758" "3759" "3760" "3761" "3762" "3763" "3764" "3765" "3766" "3767" "3768" "3769" "3770" "3771" "3772" "3773" "3774" "3775" "3776" "3777" "3778" "3779" "3780" "3781" "3782" "3783" "3784" "3785" "3786" "3787" "3788" "3789" "3790" "3791" "3792" "3793" "3794" "3795" "3796" "3797" "3798" "3799" "3800" "3801" "3802" "3803" "3804" "3805" "3806" "3807" "3808" "3809" "3810" "3811" "3812" "3813" "3814" "3815" "3816" "3817" "3818" "3819" "3820" "3821" "3822" "3823" "3824" "3825" "3826" "3827" "3828" "3829" "3830" "3831" "3832" "3833" "3834" "3835" "3836" "3837" "3838" "3839" "4011" "4111" "4112" "4119" "4121" "4131" "4214" "4215" "4225" "4411" "4457" "4468" "4511" "4582" "4722" "4723" "4784" "4789" "4812" "4813" "4814" "4815" "4816" "4821" "4829" "4899" "4900" "5013" "5021" "5039" "5044" "5045" "5046" "5047" "5051" "5065" "5072" "5074" "5085" "5094" "5099" "5111" "5122" "5131" "5137" "5139" "5169" "5172" "5192" "5193" "5198" "5199" "5200" "5211" "5231" "5251" "5261" "5262" "5271" "5292" "5293" "5300" "5309" "5310" "5311" "5331" "5399" "5411" "5422" "5441" "5451" "5462" "5499" "5511" "5521" "5531" "5532" "5533" "5541" "5542" "5551" "5552" "5561" "5571" "5592" "5598" "5599" "5611" "5621" "5631" "5641" "5651" "5655" "5661" "5681" "5691" "5697" "5698" "5699" "5712" "5713" "5714" "5715" "5718" "5719" "5722" "5723" "5732" "5733" "5734" "5735" "5811" "5812" "5813" "5814" "5815" "5816" "5817" "5818" "5912" "5921" "5931" "5932" "5933" "5935" "5937" "5940" "5941" "5942" "5943" "5944" "5945" "5946" "5947" "5948" "5949" "5950" "5960" "5962" "5963" "5964" "5965" "5966" "5967" "5968" "5969" "5970" "5971" "5972" "5973" "5975" "5976" "5977" "5978" "5983" "5992" "5993" "5994" "5995" "5996" "5997" "5998" "5999" "6010" "6011" "6012" "6050" "6051" "6211" "6300" "6513" "6520" "6532" "6533" "6536" "6537" "6538" "6540" "7011" "7012" "7032" "7033" "7210" "7211" "7216" "7217" "7221" "7230" "7251" "7261" "7273" "7276" "7277" "7278" "7295" "7296" "7297" "7298" "7299" "7311" "7321" "7322" "7333" "7338" "7339" "7342" "7349" "7361" "7372" "7375" "7379" "7392" "7393" "7394" "7395" "7399" "7512" "7513" "7519" "7523" "7531" "7534" "7535" "7538" "7542" "7549" "7622" "7623" "7629" "7631" "7641" "7692" "7699" "7800" "7801" "7802" "7829" "7832" "7841" "7911" "7922" "7929" "7932" "7933" "7941" "7991" "7992" "7993" "7994" "7995" "7996" "7997" "7998" "7999" "8011" "8021" "8031" "8041" "8042" "8043" "8049" "8050" "8062" "8071" "8099" "8111" "8211" "8220" "8241" "8244" "8249" "8299" "8351" "8398" "8641" "8651" "8661" "8675" "8699" "8734" "8911" "8931" "8999" "9211" "9222" "9223" "9311" "9399" "9402" "9405" "9406"  
Responses 
200
Payment product information updated successfully.


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


patch/v2/accounts/{account_id}/products/payment/{product_id}
Request samples 
application/json
{
  • "merchant_category_code": "5411"
}
Response samples 
application/json
{
  • "distribution_profile_id": "krn:partner:global:account:distribution-profile:206bbb83-9b6e-46fa-940d-337153c04a58",
  • "type": "PAYMENT",
  • "merchant_category_code": "5411"
}
Suspend a Payment Product
Suspends the Payment Product on an account for the given reason.


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
required
PaymentProductDefault (string) or PaymentProductIdentifier (string)
Identifier of the Payment Product the action is done on behalf of. Use default to apply the action on the unique payment product.


 
Request Body schema: application/json
required
reason
required
string
The reason for suspending the Payment Product


 Enum: "FRAUD" "VOLUNTARY"  
reason_details
required
string
Allows the partner to pass additional information regarding the suspension


 
Responses 
200
Sub account suspended


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


Callbacks 
postWebhook callback
post/v2/accounts/{account_id}/products/payment/{product_id}/disable
Request samples 
application/json
{
  • "reason": "FRAUD",
  • "reason_details": "Fraudulent activity detected"
}
Response samples 
application/json
{
  • "product_id": "krn:partner:global:account:product:payment:ad71bc48-8a07-4919-a2c1-103dba3fc918",
  • "type": "PAYMENT",
  • "distribution_profile_id": "krn:partner:global:account:distribution-profile:206bbb83-9b6e-46fa-940d-337153c04a58",
  • "merchant_category_code": "5411",
  • "state": "DISABLED",
  • "state_reason": "FRAUD_BY_PARTNER",
  • "state_context": {
    }
}
Callback payload samples 
POST: Webhook callback
application/json
The webhook is triggered once the distribution partner's account payment product is disabled.


{
  • "metadata": {
    },
  • "payload": {
    }
}
Revert suspension of a Payment Product
Revert suspension of the Payment Product on an account.


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
required
PaymentProductDefault (string) or PaymentProductIdentifier (string)
Identifier of the Payment Product the action is done on behalf of. Use default to apply the action on the unique payment product.


 
Responses 
200
Sub account suspension reverted


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


Callbacks 
postWebhook callback
post/v2/accounts/{account_id}/products/payment/{product_id}/enable
Request samples 
Response samples 
application/json
{
  • "product_id": "krn:partner:global:account:product:payment:ad71bc48-8a07-4919-a2c1-103dba3fc918",
  • "type": "PAYMENT",
  • "distribution_profile_id": "krn:partner:global:account:distribution-profile:206bbb83-9b6e-46fa-940d-337153c04a58",
  • "merchant_category_code": "5411",
  • "state": "ENABLED",
  • "state_reason": "APPROVED"
}
Callback payload samples 
POST: Webhook callback
application/json
The webhook is triggered once the distribution partner's account payment product is enabled.


{
  • "metadata": {
    },
  • "payload": {
    }
}
Suspend a Payment ProductDeprecated
Suspends the Payment Product on an account for the given reason.


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
Request Body schema: application/json
required
reason
required
string
The reason for suspending the Payment Product


 Enum: "FRAUD" "VOLUNTARY"  
reason_details
required
string
Allows the partner to pass additional information regarding the suspension


 
Responses 
200
Sub account suspended


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


Callbacks 
postWebhook callback
post/v2/accounts/{account_id}/products/payment/disable
Request samples 
application/json
{
  • "reason": "FRAUD",
  • "reason_details": "Fraudulent activity detected"
}
Response samples 
application/json
{
  • "product_id": "krn:partner:global:account:product:payment:ad71bc48-8a07-4919-a2c1-103dba3fc918",
  • "type": "PAYMENT",
  • "distribution_profile_id": "krn:partner:global:account:distribution-profile:206bbb83-9b6e-46fa-940d-337153c04a58",
  • "merchant_category_code": "5411",
  • "state": "DISABLED",
  • "state_reason": "FRAUD_BY_PARTNER",
  • "state_context": {
    }
}
Callback payload samples 
POST: Webhook callback
application/json
The webhook is triggered once the distribution partner's account payment product is disabled.


{
  • "metadata": {
    },
  • "payload": {
    }
}
Revert suspension of a Payment ProductDeprecated
Revert suspension of the Payment Product on an account.


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
Responses 
200
Sub account suspension reverted


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


Callbacks 
postWebhook callback
post/v2/accounts/{account_id}/products/payment/enable
Request samples 
Response samples 
application/json
{
  • "product_id": "krn:partner:global:account:product:payment:ad71bc48-8a07-4919-a2c1-103dba3fc918",
  • "type": "PAYMENT",
  • "distribution_profile_id": "krn:partner:global:account:distribution-profile:206bbb83-9b6e-46fa-940d-337153c04a58",
  • "merchant_category_code": "5411",
  • "state": "ENABLED",
  • "state_reason": "APPROVED"
}
Callback payload samples 
POST: Webhook callback
application/json
The webhook is triggered once the distribution partner's account payment product is enabled.


{
  • "metadata": {
    },
  • "payload": {
    }
}
Migration
Onboard a legacy merchant
Onboard an existing merchant to Management API. This request overwrites all existing data with the new data provided.


Securityklarna_api_key 
Request 
Request Body schema: application/json
required
account_reference
required
string
Reference for the Distribution Partner in relation to the merchant being onboarded.


 
account_name
required
string
The name of the account, business name or similar.


 
required
object
The account owner details


 
account_group_reference
string
Partners can group several merchant accounts under given account_group_reference


 
account_group_id
string (AccountGroupIdentifier) 
Group id assigned by Klarna for a given account_group_reference. Partners can use this parameter as an alternative to account_group_reference to manage an account group.


 
required
Array of objects (PaymentProductMigrationData) 
Information about which products are being configured for this account


 
required
object (ChannelData) 
Root channel object


 
object (ExtraAccountData) 
Root extra account data object


 
Responses 
200
Merchant account created


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


Callbacks 
postWebhook callback
post/v2/distribution/migrate
Request samples 
application/json
{
  • "account_reference": "M123786123412",
  • "account_name": "John Doe Stakehouse",
  • "account_owner": {
    },
  • "products": [
    ],
  • "channel": {}
}
Response samples 
application/json
{
  • "account_id": "krn:partner:global:account:live:LWT2XJSE",
  • "account_reference": "M123786123412",
  • "account_name": "Merchant ABC US",
  • "state": "PARTIALLY_OPERATIONAL",
  • "state_reason": "INITIAL_SETUP"
}
Callback payload samples 
POST: Webhook callback
application/json
The webhook is triggered once the distribution partner's account state changes.


{
  • "metadata": {
    },
  • "payload": {
    }
}
Websites
The Accounts API allows the authenticated Partner to create, read, manage the Web Domains channel on an Account.


List all website channels
Fetch all website channels of an account


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
Responses 
200
Website channel found


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/accounts/{account_id}/channel/websites
Request samples 
Response samples 
application/json
[
  • {
    }
]
Update a website channel
Update a website channel from an account


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
website_id
required
string (WebsiteIdentifier) 
Unique identifier assigned by Klarna to this website


 
 Example:  krn:partner:global:account:channel:website:206bbb83-9b6e-46fa-940d-337153c04a58
Request Body schema: application/json
required
urls
Array of strings  <= 2083 characters 
The applicable base domain urls for the website


 
website_name
string  <= 80 characters 
The website's name.


 
website_reference
string  <= 80 characters 
The reference assigned by the partner to this website


 
channel_collection_reference
string  <= 80 characters 
The reference to the channel collection associated to the website object


 
channel_collection_id
string (CollectionIdentifier) 
Unique identifier assigned by Klarna to the channel collection defined


 
Responses 
200
Website channel updated


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


patch/v2/accounts/{account_id}/channel/websites/{website_id}
Request samples 
application/json
{
  • "urls": [],
  • "website_name": "John Doe Stakehouse",
  • "website_reference": "999888777",
  • "channel_collection_reference": "online-stores",
  • "channel_collection_id": "krn:partner:global:account:channel:collection:cad7a851-8f59-47ed-8b1f-e1d61a0e817c"
}
Response samples 
application/json
{
  • "website_id": "krn:partner:global:account:channel:website:206bbb83-9b6e-46fa-940d-337153c04a58",
  • "urls": [],
  • "website_name": "John Doe Stakehouse",
  • "website_reference": "999888777",
  • "channel_collection_reference": "online-stores",
  • "channel_collection_id": "krn:partner:global:account:channel:collection:cad7a851-8f59-47ed-8b1f-e1d61a0e817c"
}
Collections
The Accounts API allows the authenticated Partner to create, read, manage the Collections channel on an Account.


List all collection channels
Fetch all collection channels of an account


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
Responses 
200
Collection channel found


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/accounts/{account_id}/channel/collections
Request samples 
Response samples 
application/json
[]
Update a collection channel
Update a collection channel from an account


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
collection_id
required
string (CollectionIdentifier) 
Unique identifier assigned by Klarna to the channel collection defined


 
 Example:  krn:partner:global:account:channel:collection:cad7a851-8f59-47ed-8b1f-e1d61a0e817c
Request Body schema: application/json
required
collection_reference
string  <= 80 characters 
The collection reference which can be assigned to a given websites[]


 
object (Branding) 
The branding assets defined for the collection


 
object (SupportContact) 
The list of customer support contact point


 
Array of objects (SocialMediaLinks) 
 
Responses 
200
Collection channel updated


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


patch/v2/accounts/{account_id}/channel/collections/{collection_id}
Request samples 
application/json
{}
Response samples 
application/json
{}
Account information
The Accounts API allows the authenticated Partner to provide additional information for a given merchant, e.g the IP address used by the merchant when signing up for an account with the partner and the corresponding timestamp


Fetch the account information
Fetch the account information


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
Responses 
200
Business information found


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/accounts/{account_id}/extra-account-data/account-information
Request samples 
Response samples 
application/json
{
  • "account_created_from_ip": "192.168.1.1",
  • "account_created_at": "2024-01-01T12:00:00Z"
}
Update the account information
Update the account information of an existing account


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
Request Body schema: application/json
required
account_created_from_ip
string <ip_address>  (IpAddress) ^((([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25...
Valid IPV4 or IPV6 address


 
account_created_at
string <date-time>  (Timestamp) ^[0-9][0-9][0-9][0-9]-[0-1][0-9]-[0-3][0-9]T[...
Timestamp in ISO 8601 with timezone e.g. 2024-01-01T12:00:00Z


 
Responses 
200
Account information updated


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


409
Account information can only be set once


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


patch/v2/accounts/{account_id}/extra-account-data/account-information
Request samples 
application/json
{
  • "account_created_from_ip": "192.168.1.1",
  • "account_created_at": "2024-01-01T12:00:00Z"
}
Response samples 
application/json
{
  • "account_created_from_ip": "192.168.1.1",
  • "account_created_at": "2024-01-01T12:00:00Z"
}
Business information
The Accounts API allows the authenticated Partner to provide additional detailed business information for a given merchant, for example the business registration address and registration number.


Fetch the business information for the account
Fetch the business information for the account


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
Responses 
200
Business information found


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/accounts/{account_id}/extra-account-data/business-information
Request samples 
Response samples 
application/json
{
  • "business_name": "John Doe LLC",
  • "business_entity_type": "LIMITED_LIABILITY_COMPANY",
  • "registration_authority": "Ohio",
  • "registration_number": "12345678",
  • "tax_registration_number": "999-999-999",
  • "financial_registration_number": "12345678",
  • "operating_address": {
    },
  • "registration_address": {
    }
}
Update the business information
Update the business information of an existing account


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
Request Body schema: application/json
required
business_name
string  <= 80 characters 
Registered Business name


 
business_entity_type
string
Legal status of the business


 Enum: "SOLE_TRADER" "STATE_OWNED_COMPANY" "ASSOCIATION" "PUBLIC_LIMITED_COMPANY" "PRIVATE_UNLIMITED_COMPANY" "COOPERATIVE" "FOUNDATION" "NON_PROFIT_ORGANISATION" "PARTNERSHIP" "LIMITED_LIABILITY_COMPANY" "TRUST" "UNKNOWN"  
registration_authority
string
The authority / local court where the company is registered


 
registration_number
string
Identification number assigned to a business entity when it is registered with a government authority


 
tax_registration_number
string
The unique number that identifies a taxable business or non-taxable legal entity that is registered for VAT/Sales Tax


 
financial_registration_number
string
The financial license number as registered with the authorities


 
object
The root object for the operational business address


 
object
The root object for the registered business address


 
Responses 
200
Business information updated


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


patch/v2/accounts/{account_id}/extra-account-data/business-information
Request samples 
application/json
{
  • "business_name": "John Doe LLC",
  • "business_entity_type": "LIMITED_LIABILITY_COMPANY",
  • "registration_authority": "Ohio",
  • "registration_number": "12345678",
  • "tax_registration_number": "999-999-999",
  • "financial_registration_number": "12345678",
  • "operating_address": {
    },
  • "registration_address": {
    }
}
Response samples 
application/json
{
  • "business_name": "John Doe LLC",
  • "business_entity_type": "LIMITED_LIABILITY_COMPANY",
  • "registration_authority": "Ohio",
  • "registration_number": "12345678",
  • "tax_registration_number": "999-999-999",
  • "financial_registration_number": "12345678",
  • "operating_address": {
    },
  • "registration_address": {
    }
}
Beneficiary information
The Accounts API allows the authenticated Partner to create, read, manage the Beneficiary Information on an Account.


Register a stakeholder
Register a stakeholder on an existing account


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
Request Body schema: application/json
required
given_name
string  [ 1 .. 99 ] characters 
The stakeholder given name


 
family_name
string  [ 1 .. 99 ] characters 
The stakeholder family name


 
object
The root object for the stakeholder address


 
date_of_birth
string (DateOfBirth) ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
Date of birth of the person on the format YYYY-MM-DD


 
object
National Identification Number for a person. The number is formatted according to country standards.


 
roles
required
Array of strings
List of roles this stakeholder has in the business


Items Enum: "LEGAL_REPRESENTATIVE" "ALTERNATIVE_BENEFICIAL_OWNER" "ULTIMATE_BENEFICIAL_OWNER" "OWNER"  
Responses 
200
Stakeholder registered


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


post/v2/accounts/{account_id}/extra-account-data/beneficiary-information/stakeholders
Request samples 
application/json
{
  • "given_name": "John",
  • "family_name": "Doe",
  • "address": {
    },
  • "date_of_birth": "1970-01-01",
  • "national_identification": {
    },
  • "roles": [
    ]
}
Response samples 
application/json
{
  • "stakeholder_id": "krn:partner:global:account:stakeholder:206bbb83-9b6e-46fa-940d-337153c04a58",
  • "given_name": "John",
  • "family_name": "Doe",
  • "address": {
    },
  • "date_of_birth": "1970-01-01",
  • "national_identification": {
    },
  • "roles": [
    ]
}
List all stakeholders
Fetch all stakeholders on an account


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
Responses 
200
Stakeholders found


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/accounts/{account_id}/extra-account-data/beneficiary-information/stakeholders
Request samples 
Response samples 
application/json
[
  • {
    }
]
Retrieve a stakeholder
Retrieve a stakeholder from an existing account


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
stakeholder_id
required
string (StakeholderIdentifier) 
Unique identifier for this stakeholder


 
 Example:  krn:partner:global:account:stakeholder:206bbb83-9b6e-46fa-940d-337153c04a58
Responses 
200
Stakeholder found


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/accounts/{account_id}/extra-account-data/beneficiary-information/stakeholders/{stakeholder_id}
Request samples 
Response samples 
application/json
{
  • "stakeholder_id": "krn:partner:global:account:stakeholder:206bbb83-9b6e-46fa-940d-337153c04a58",
  • "given_name": "John",
  • "family_name": "Doe",
  • "address": {
    },
  • "date_of_birth": "1970-01-01",
  • "national_identification": {
    },
  • "roles": [
    ]
}
Update a stakeholder
Update a stakeholder on an account


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
stakeholder_id
required
string (StakeholderIdentifier) 
Unique identifier for this stakeholder


 
 Example:  krn:partner:global:account:stakeholder:206bbb83-9b6e-46fa-940d-337153c04a58
Request Body schema: application/json
required
given_name
string  [ 1 .. 99 ] characters 
The stakeholder given name


 
family_name
string  [ 1 .. 99 ] characters 
The stakeholder family name


 
object
The root object for the stakeholder address


 
date_of_birth
string (DateOfBirth) ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
Date of birth of the person on the format YYYY-MM-DD


 
object
National Identification Number for a person. The number is formatted according to country standards.


 
roles
required
Array of strings
List of roles this stakeholder has in the business


Items Enum: "LEGAL_REPRESENTATIVE" "ALTERNATIVE_BENEFICIAL_OWNER" "ULTIMATE_BENEFICIAL_OWNER" "OWNER"  
Responses 
200
Stakeholder updated


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


patch/v2/accounts/{account_id}/extra-account-data/beneficiary-information/stakeholders/{stakeholder_id}
Request samples 
application/json
{
  • "given_name": "John",
  • "family_name": "Doe",
  • "address": {
    },
  • "date_of_birth": "1970-01-01",
  • "national_identification": {
    },
  • "roles": [
    ]
}
Response samples 
application/json
{
  • "stakeholder_id": "krn:partner:global:account:stakeholder:206bbb83-9b6e-46fa-940d-337153c04a58",
  • "given_name": "John",
  • "family_name": "Doe",
  • "address": {
    },
  • "date_of_birth": "1970-01-01",
  • "national_identification": {
    },
  • "roles": [
    ]
}
Delete a Stakeholder
Remove a given stakeholder from an account


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
stakeholder_id
required
string (StakeholderIdentifier) 
Unique identifier for this stakeholder


 
 Example:  krn:partner:global:account:stakeholder:206bbb83-9b6e-46fa-940d-337153c04a58
Responses 
204
Stakeholder removed


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


delete/v2/accounts/{account_id}/extra-account-data/beneficiary-information/stakeholders/{stakeholder_id}
Request samples 
Response samples 
application/json
{
  • "error_id": "5a3f6b9c-9b3b-4b7e-8f9d-9b9a4b9a4b9a",
  • "error_type": "INPUT_ERROR",
  • "error_code": "INVALID_CONTENT_TYPE",
  • "error_message": "The received input is not valid JSON.\nUnterminated string at 19 [character 20 line 1].\n"
}
Settlement information
The Accounts API allows the authenticated Partner to share the settlement information for a given merchant which Klarna would solely use for KYB (Know Your Business) purposes.


Retrieve settlement information
Retrieve the settlement information


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
Responses 
200
Settlement information found


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/accounts/{account_id}/extra-account-data/settlement-information
Request samples 
Response samples 
application/json
{
  • "settlement_enabled": true,
  • "settlement_enabled_at": "2024-01-01T12:00:00Z"
}
Update settlement information
Update settlement information


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
Request Body schema: application/json
required
settlement_enabled
boolean
Are payouts enabled


 
settlement_enabled_at
string <date-time>  (Timestamp) ^[0-9][0-9][0-9][0-9]-[0-1][0-9]-[0-3][0-9]T[...
Timestamp in ISO 8601 with timezone e.g. 2024-01-01T12:00:00Z


 
Responses 
200
Settlement information updated


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


patch/v2/accounts/{account_id}/extra-account-data/settlement-information
Request samples 
application/json
{
  • "settlement_enabled": true,
  • "settlement_enabled_at": "2024-01-01T12:00:00Z"
}
Response samples 
application/json
{
  • "settlement_enabled": true,
  • "settlement_enabled_at": "2024-01-01T12:00:00Z"
}
Add bank account information
Add bank account information


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
Request Body schema: application/json
required
bank_account_type
required
string (BankAccountType) 
The settlement type available for a given currency


 
account_holder
string (AccountHolder) 
The account holder name


 
bic
required
string (Bic)   [ 8 .. 11 ] characters 
The bank's 8- or 11-character BIC or SWIFT code.


 
iban
required
string
The international bank account number as defined in the ISO-13616 standard.


 
Responses 
200
Bank account information added


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


post/v2/accounts/{account_id}/extra-account-data/settlement-information/bank-accounts
Request samples 
application/json
{
  • "bank_account_type": "IBAN",
  • "account_holder": "John Doe Stakehouse",
  • "bic": "NDEASEGGXXX",
  • "iban": "SE4550000000058398257466"
}
Response samples 
application/json
{
  • "bank_account_id": "krn:partner:global:settlement-information:bank-account:56f77163-bc1b-46c8-a245-e251ff65e3d2",
  • "bank_account_type": "IBAN",
  • "account_holder": "John Doe Stakehouse",
  • "bic": "NDEASEGGXXX",
  • "iban": "SE4550000000058398257466"
}
List all bank account information
List all bank account information


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
Responses 
200
Bank account information found


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/accounts/{account_id}/extra-account-data/settlement-information/bank-accounts
Request samples 
Response samples 
application/json
[
  • {
    }
]
Retrieve bank account information
Retrieve a bank account information from an existing account


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
bank_account_id
required
string (BankAccountIdentifier) 
Unique identifier assigned to the bank information provided


 
 Example:  krn:partner:global:settlement-information:bank-account:56f77163-bc1b-46c8-a245-e251ff65e3d2
Responses 
200
Stakeholder found


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/accounts/{account_id}/extra-account-data/settlement-information/bank-accounts/{bank_account_id}
Request samples 
Response samples 
application/json
{
  • "bank_account_id": "krn:partner:global:settlement-information:bank-account:56f77163-bc1b-46c8-a245-e251ff65e3d2",
  • "bank_account_type": "IBAN",
  • "account_holder": "John Doe Stakehouse",
  • "bic": "NDEASEGGXXX",
  • "iban": "SE4550000000058398257466"
}
Update bank account information
Update bank detail information for a given account


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
bank_account_id
required
string (BankAccountIdentifier) 
Unique identifier assigned to the bank information provided


 
 Example:  krn:partner:global:settlement-information:bank-account:56f77163-bc1b-46c8-a245-e251ff65e3d2
Request Body schema: application/json
required
bank_account_type
required
string (BankAccountType) 
The settlement type available for a given currency


 
account_holder
string (AccountHolder) 
The account holder name


 
bic
required
string (Bic)   [ 8 .. 11 ] characters 
The bank's 8- or 11-character BIC or SWIFT code.


 
iban
required
string
The international bank account number as defined in the ISO-13616 standard.


 
Responses 
200
Bank account information updated


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


patch/v2/accounts/{account_id}/extra-account-data/settlement-information/bank-accounts/{bank_account_id}
Request samples 
application/json
{
  • "bank_account_type": "IBAN",
  • "account_holder": "John Doe Stakehouse",
  • "bic": "NDEASEGGXXX",
  • "iban": "SE4550000000058398257466"
}
Response samples 
application/json
{
  • "bank_account_id": "krn:partner:global:settlement-information:bank-account:56f77163-bc1b-46c8-a245-e251ff65e3d2",
  • "bank_account_type": "IBAN",
  • "account_holder": "John Doe Stakehouse",
  • "bic": "NDEASEGGXXX",
  • "iban": "SE4550000000058398257466"
}
Delete bank account information
Remove bank account information from an account


Securityklarna_api_key 
Request 
path Parameters
account_id
required
string (AccountIdentifier) 
Identifier of the Account the action is done on behalf of


 
 Example:  krn:partner:global:account:live:LWT2XJSE
bank_account_id
required
string (BankAccountIdentifier) 
Unique identifier assigned to the bank information provided


 
 Example:  krn:partner:global:settlement-information:bank-account:56f77163-bc1b-46c8-a245-e251ff65e3d2
Responses 
204
Bank account information removed


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


delete/v2/accounts/{account_id}/extra-account-data/settlement-information/bank-accounts/{bank_account_id}
Request samples 
Response samples 
application/json
{
  • "error_id": "5a3f6b9c-9b3b-4b7e-8f9d-9b9a4b9a4b9a",
  • "error_type": "INPUT_ERROR",
  • "error_code": "INVALID_CONTENT_TYPE",
  • "error_message": "The received input is not valid JSON.\nUnterminated string at 19 [character 20 line 1].\n"
}
Price Plans
The Partner Management API allows the Partners to consult the Price plans in place for their account


Fetch all Price Plans
Fetch all Price Plans available for the partner.


Securityklarna_api_key 
Responses 
200
Price Plan list


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/distribution/products/payment/price-plans
Request samples 
Response samples 
application/json
{
  • "price_plan_id": "krn:partner:global:pricing:payment:price-plan:ad71bc48-8a07-4919-a2c1",
  • "name": "price plan",
  • "description": "Default Price Plan",
  • "versions": [
    ]
}
Read a Price Plan
A Price Plan is the definition of how a Payment transaction is priced towards the Partner. At least one query parameter is required.


Securityklarna_api_key 
Request 
path Parameters
price_plan_id
required
string (PricePlanIdentifier) 
Identifier of the requested Price Plan


 
 Example:  krn:partner:global:pricing:payments:price-plan:171080e7-2637-4675-a224-ec032723ebdf
query Parameters
merchant_category_code
string (merchant-category.model_MerchantCategoryCode) 
The Merchant Category Code (MCC) is a four-digit number that is used to classify the type of goods or services
offered by a business.
[Read more here (https://docs.klarna.com/klarna-network-distribution/manage-partners/merchant-category-code)


 Enum: "0742" "0743" "0744" "0763" "0780" "1520" "1711" "1731" "1740" "1750" "1761" "1771" "1799" "2741" "2791" "2842" "3000" "3001" "3002" "3003" "3004" "3005" "3006" "3007" "3008" "3009" "3010" "3011" "3012" "3013" "3014" "3015" "3016" "3017" "3018" "3019" "3020" "3021" "3022" "3023" "3024" "3025" "3026" "3027" "3028" "3029" "3030" "3031" "3032" "3033" "3034" "3035" "3036" "3037" "3038" "3039" "3040" "3041" "3042" "3043" "3044" "3045" "3046" "3047" "3048" "3049" "3050" "3051" "3052" "3053" "3054" "3055" "3056" "3057" "3058" "3059" "3060" "3061" "3062" "3063" "3064" "3065" "3066" "3067" "3068" "3069" "3070" "3071" "3072" "3075" "3076" "3077" "3078" "3079" "3080" "3081" "3082" "3083" "3084" "3085" "3086" "3087" "3088" "3089" "3090" "3094" "3096" "3097" "3098" "3099" "3100" "3102" "3103" "3106" "3110" "3111" "3112" "3115" "3117" "3118" "3125" "3126" "3127" "3129" "3130" "3131" "3132" "3133" "3135" "3136" "3137" "3138" "3143" "3144" "3145" "3146" "3148" "3151" "3154" "3156" "3159" "3161" "3164" "3165" "3167" "3170" "3171" "3172" "3174" "3175" "3176" "3177" "3178" "3180" "3181" "3182" "3183" "3184" "3185" "3186" "3187" "3188" "3190" "3191" "3193" "3196" "3197" "3200" "3203" "3204" "3206" "3211" "3212" "3213" "3215" "3216" "3217" "3218" "3219" "3220" "3221" "3222" "3223" "3226" "3228" "3229" "3231" "3233" "3234" "3235" "3236" "3238" "3239" "3240" "3241" "3242" "3243" "3245" "3246" "3247" "3248" "3251" "3252" "3253" "3254" "3256" "3259" "3260" "3261" "3262" "3263" "3266" "3267" "3280" "3282" "3284" "3285" "3286" "3287" "3292" "3293" "3294" "3295" "3296" "3297" "3298" "3299" "3300" "3301" "3302" "3303" "3308" "3351" "3352" "3353" "3354" "3355" "3357" "3359" "3360" "3361" "3362" "3364" "3366" "3368" "3370" "3374" "3376" "3380" "3381" "3385" "3386" "3387" "3388" "3389" "3390" "3391" "3393" "3394" "3395" "3396" "3398" "3400" "3405" "3409" "3414" "3420" "3421" "3423" "3425" "3427" "3428" "3429" "3430" "3431" "3432" "3433" "3434" "3435" "3436" "3437" "3438" "3439" "3441" "3501" "3502" "3503" "3504" "3505" "3506" "3507" "3508" "3509" "3510" "3511" "3512" "3513" "3514" "3515" "3516" "3517" "3518" "3519" "3520" "3521" "3522" "3523" "3524" "3525" "3526" "3527" "3528" "3529" "3530" "3531" "3532" "3533" "3534" "3535" "3536" "3537" "3538" "3539" "3540" "3541" "3542" "3543" "3544" "3545" "3546" "3547" "3548" "3549" "3550" "3551" "3552" "3553" "3554" "3555" "3556" "3557" "3558" "3559" "3560" "3561" "3562" "3563" "3564" "3565" "3566" "3567" "3568" "3569" "3570" "3571" "3572" "3573" "3574" "3575" "3576" "3577" "3578" "3579" "3580" "3581" "3582" "3583" "3584" "3585" "3586" "3587" "3588" "3589" "3590" "3591" "3592" "3593" "3594" "3595" "3596" "3597" "3598" "3599" "3600" "3601" "3602" "3603" "3604" "3607" "3608" "3609" "3612" "3613" "3614" "3615" "3617" "3618" "3619" "3620" "3621" "3622" "3623" "3624" "3625" "3626" "3627" "3628" "3629" "3630" "3631" "3632" "3633" "3634" "3635" "3636" "3637" "3638" "3639" "3640" "3641" "3642" "3643" "3644" "3645" "3646" "3647" "3648" "3649" "3650" "3651" "3652" "3653" "3654" "3655" "3656" "3657" "3658" "3659" "3660" "3661" "3662" "3663" "3664" "3665" "3666" "3667" "3668" "3669" "3670" "3671" "3672" "3673" "3674" "3675" "3676" "3677" "3678" "3679" "3680" "3681" "3682" "3683" "3684" "3685" "3686" "3687" "3688" "3689" "3690" "3691" "3692" "3693" "3694" "3695" "3696" "3697" "3698" "3699" "3700" "3701" "3702" "3703" "3704" "3705" "3706" "3707" "3708" "3709" "3710" "3711" "3712" "3713" "3714" "3715" "3716" "3717" "3718" "3719" "3720" "3721" "3722" "3723" "3724" "3725" "3726" "3727" "3728" "3729" "3730" "3731" "3732" "3733" "3734" "3735" "3736" "3737" "3738" "3739" "3740" "3741" "3742" "3743" "3744" "3745" "3746" "3747" "3748" "3749" "3750" "3751" "3752" "3753" "3754" "3755" "3756" "3757" "3758" "3759" "3760" "3761" "3762" "3763" "3764" "3765" "3766" "3767" "3768" "3769" "3770" "3771" "3772" "3773" "3774" "3775" "3776" "3777" "3778" "3779" "3780" "3781" "3782" "3783" "3784" "3785" "3786" "3787" "3788" "3789" "3790" "3791" "3792" "3793" "3794" "3795" "3796" "3797" "3798" "3799" "3800" "3801" "3802" "3803" "3804" "3805" "3806" "3807" "3808" "3809" "3810" "3811" "3812" "3813" "3814" "3815" "3816" "3817" "3818" "3819" "3820" "3821" "3822" "3823" "3824" "3825" "3826" "3827" "3828" "3829" "3830" "3831" "3832" "3833" "3834" "3835" "3836" "3837" "3838" "3839" "4011" "4111" "4112" "4119" "4121" "4131" "4214" "4215" "4225" "4411" "4457" "4468" "4511" "4582" "4722" "4723" "4784" "4789" "4812" "4813" "4814" "4815" "4816" "4821" "4829" "4899" "4900" "5013" "5021" "5039" "5044" "5045" "5046" "5047" "5051" "5065" "5072" "5074" "5085" "5094" "5099" "5111" "5122" "5131" "5137" "5139" "5169" "5172" "5192" "5193" "5198" "5199" "5200" "5211" "5231" "5251" "5261" "5262" "5271" "5292" "5293" "5300" "5309" "5310" "5311" "5331" "5399" "5411" "5422" "5441" "5451" "5462" "5499" "5511" "5521" "5531" "5532" "5533" "5541" "5542" "5551" "5552" "5561" "5571" "5592" "5598" "5599" "5611" "5621" "5631" "5641" "5651" "5655" "5661" "5681" "5691" "5697" "5698" "5699" "5712" "5713" "5714" "5715" "5718" "5719" "5722" "5723" "5732" "5733" "5734" "5735" "5811" "5812" "5813" "5814" "5815" "5816" "5817" "5818" "5912" "5921" "5931" "5932" "5933" "5935" "5937" "5940" "5941" "5942" "5943" "5944" "5945" "5946" "5947" "5948" "5949" "5950" "5960" "5962" "5963" "5964" "5965" "5966" "5967" "5968" "5969" "5970" "5971" "5972" "5973" "5975" "5976" "5977" "5978" "5983" "5992" "5993" "5994" "5995" "5996" "5997" "5998" "5999" "6010" "6011" "6012" "6050" "6051" "6211" "6300" "6513" "6520" "6532" "6533" "6536" "6537" "6538" "6540" "7011" "7012" "7032" "7033" "7210" "7211" "7216" "7217" "7221" "7230" "7251" "7261" "7273" "7276" "7277" "7278" "7295" "7296" "7297" "7298" "7299" "7311" "7321" "7322" "7333" "7338" "7339" "7342" "7349" "7361" "7372" "7375" "7379" "7392" "7393" "7394" "7395" "7399" "7512" "7513" "7519" "7523" "7531" "7534" "7535" "7538" "7542" "7549" "7622" "7623" "7629" "7631" "7641" "7692" "7699" "7800" "7801" "7802" "7829" "7832" "7841" "7911" "7922" "7929" "7932" "7933" "7941" "7991" "7992" "7993" "7994" "7995" "7996" "7997" "7998" "7999" "8011" "8021" "8031" "8041" "8042" "8043" "8049" "8050" "8062" "8071" "8099" "8111" "8211" "8220" "8241" "8244" "8249" "8299" "8351" "8398" "8641" "8651" "8661" "8675" "8699" "8734" "8911" "8931" "8999" "9211" "9222" "9223" "9311" "9399" "9402" "9405" "9406"  
 Example:  merchant_category_code=5411
date_time
string <date-time>  (Timestamp) ^[0-9][0-9][0-9][0-9]-[0-1][0-9]-[0-3][0-9]T[...
Retrieves price plan data for specified date time in UTC. If not provided, the current date will be used.


 
 Example:  date_time=2024-01-01T12:00:00Z
version
number (PricePlanVersionNumber) 
Version number of Price Plan


 
currency
string (Currency) ^[A-Za-z]{3}$
Currency in ISO 4217 format.


Supported currencies:


    

  • AUD
    • 

  • EUR
    • 

  • CAD
    • 

  • CZK
    • 

  • DKK
    • 

  • HUF
    • 

  • MXN
    • 

  • NZD
    • 

  • NOK
    • 

  • PLN
    • 

  • RON
    • 

  • SEK
    • 

  • CHF
    • 

  • GBP
    • 

  • USD
    • 



 
 Example:  currency=USD
country
string (Country) ^[A-Za-z]{2}$
Country in ISO 3166-1 alpha-2 format.


 
 Example:  country=US
payment_program_id
string (PaymentProgramId) 
Applied payment program id


 
 Example:  payment_program_id=krn:partner:global:pricing:payments:program:a5cd46f7e-573d-4b02-bab8-1f1c0e343291
size
integer <int32> 
Limits the number of items to be returned. If omitted, the default page size will be used.


 
 Example:  size=20
starting_after
string
A cursor used in pagination, referring to a specific item. The last_item returned from a previous call can be used here. The next page will list items after this item. Cannot be used together with ending_before. If both starting_after and ending_before are omitted, the first page will be returned.


 
 Example:  starting_after=Zpq6F3mDYtwK8
ending_before
string
A cursor used in pagination, referring to a specific item. The first_item returned from a previous call can be used here. The next page will list items up until, but not including, this item. Cannot be used together with starting_after. If both starting_after and ending_before are omitted, the first page will be returned.


 
 Example:  ending_before=Zpq6F3mDYtwK8
Responses 
200
Price Plan was successfully found by provided price plan id, mcc and date


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/distribution/products/payment/price-plans/{price_plan_id}
Request samples 
Response samples 
application/json
{
  • "price_plan_id": "krn:partner:global:pricing:payments:price-plan:ad71bc48-8a07-4919-a2c1",
  • "name": "price plan",
  • "description": "Default Price Plan",
  • "rates": [
    ],
  • "version": 1,
  • "effective_from": "2024-01-01T12:00:00Z",
  • "comment": "Active, effective post Jan 1 2024",
  • "pagination": {
    }
}
Payment Programs
The Payment Programs API allows the Partners to list their payment programs and enable an optional payment program.


Read Payment Program Plans
Read payment program plans.


Securityklarna_api_key 
Responses 
200
Payment program plans.


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/distribution/products/payment/payment-program-plans
Request samples 
Response samples 
application/json
{
  • "payment_program_plans": [
    ]
}
List all Payment Programs for a Payment Program Plan
List all payment programs for a payment program plan identifier.


Securityklarna_api_key 
Request 
path Parameters
payment_program_plan_id
required
string (PaymentProgramPlanIdentifier) 
Identifier of the payment program plan.


 
 Example:  krn:partner:global:payment:program:plan:33deb549-aa35-4102-b9ec-56c527386111
query Parameters
merchant_category_code
string (merchant-category.model_MerchantCategoryCode) 
The Merchant Category Code (MCC) is a four-digit number that is used to classify the type of goods or services
offered by a business.
[Read more here (https://docs.klarna.com/klarna-network-distribution/manage-partners/merchant-category-code)


 Enum: "0742" "0743" "0744" "0763" "0780" "1520" "1711" "1731" "1740" "1750" "1761" "1771" "1799" "2741" "2791" "2842" "3000" "3001" "3002" "3003" "3004" "3005" "3006" "3007" "3008" "3009" "3010" "3011" "3012" "3013" "3014" "3015" "3016" "3017" "3018" "3019" "3020" "3021" "3022" "3023" "3024" "3025" "3026" "3027" "3028" "3029" "3030" "3031" "3032" "3033" "3034" "3035" "3036" "3037" "3038" "3039" "3040" "3041" "3042" "3043" "3044" "3045" "3046" "3047" "3048" "3049" "3050" "3051" "3052" "3053" "3054" "3055" "3056" "3057" "3058" "3059" "3060" "3061" "3062" "3063" "3064" "3065" "3066" "3067" "3068" "3069" "3070" "3071" "3072" "3075" "3076" "3077" "3078" "3079" "3080" "3081" "3082" "3083" "3084" "3085" "3086" "3087" "3088" "3089" "3090" "3094" "3096" "3097" "3098" "3099" "3100" "3102" "3103" "3106" "3110" "3111" "3112" "3115" "3117" "3118" "3125" "3126" "3127" "3129" "3130" "3131" "3132" "3133" "3135" "3136" "3137" "3138" "3143" "3144" "3145" "3146" "3148" "3151" "3154" "3156" "3159" "3161" "3164" "3165" "3167" "3170" "3171" "3172" "3174" "3175" "3176" "3177" "3178" "3180" "3181" "3182" "3183" "3184" "3185" "3186" "3187" "3188" "3190" "3191" "3193" "3196" "3197" "3200" "3203" "3204" "3206" "3211" "3212" "3213" "3215" "3216" "3217" "3218" "3219" "3220" "3221" "3222" "3223" "3226" "3228" "3229" "3231" "3233" "3234" "3235" "3236" "3238" "3239" "3240" "3241" "3242" "3243" "3245" "3246" "3247" "3248" "3251" "3252" "3253" "3254" "3256" "3259" "3260" "3261" "3262" "3263" "3266" "3267" "3280" "3282" "3284" "3285" "3286" "3287" "3292" "3293" "3294" "3295" "3296" "3297" "3298" "3299" "3300" "3301" "3302" "3303" "3308" "3351" "3352" "3353" "3354" "3355" "3357" "3359" "3360" "3361" "3362" "3364" "3366" "3368" "3370" "3374" "3376" "3380" "3381" "3385" "3386" "3387" "3388" "3389" "3390" "3391" "3393" "3394" "3395" "3396" "3398" "3400" "3405" "3409" "3414" "3420" "3421" "3423" "3425" "3427" "3428" "3429" "3430" "3431" "3432" "3433" "3434" "3435" "3436" "3437" "3438" "3439" "3441" "3501" "3502" "3503" "3504" "3505" "3506" "3507" "3508" "3509" "3510" "3511" "3512" "3513" "3514" "3515" "3516" "3517" "3518" "3519" "3520" "3521" "3522" "3523" "3524" "3525" "3526" "3527" "3528" "3529" "3530" "3531" "3532" "3533" "3534" "3535" "3536" "3537" "3538" "3539" "3540" "3541" "3542" "3543" "3544" "3545" "3546" "3547" "3548" "3549" "3550" "3551" "3552" "3553" "3554" "3555" "3556" "3557" "3558" "3559" "3560" "3561" "3562" "3563" "3564" "3565" "3566" "3567" "3568" "3569" "3570" "3571" "3572" "3573" "3574" "3575" "3576" "3577" "3578" "3579" "3580" "3581" "3582" "3583" "3584" "3585" "3586" "3587" "3588" "3589" "3590" "3591" "3592" "3593" "3594" "3595" "3596" "3597" "3598" "3599" "3600" "3601" "3602" "3603" "3604" "3607" "3608" "3609" "3612" "3613" "3614" "3615" "3617" "3618" "3619" "3620" "3621" "3622" "3623" "3624" "3625" "3626" "3627" "3628" "3629" "3630" "3631" "3632" "3633" "3634" "3635" "3636" "3637" "3638" "3639" "3640" "3641" "3642" "3643" "3644" "3645" "3646" "3647" "3648" "3649" "3650" "3651" "3652" "3653" "3654" "3655" "3656" "3657" "3658" "3659" "3660" "3661" "3662" "3663" "3664" "3665" "3666" "3667" "3668" "3669" "3670" "3671" "3672" "3673" "3674" "3675" "3676" "3677" "3678" "3679" "3680" "3681" "3682" "3683" "3684" "3685" "3686" "3687" "3688" "3689" "3690" "3691" "3692" "3693" "3694" "3695" "3696" "3697" "3698" "3699" "3700" "3701" "3702" "3703" "3704" "3705" "3706" "3707" "3708" "3709" "3710" "3711" "3712" "3713" "3714" "3715" "3716" "3717" "3718" "3719" "3720" "3721" "3722" "3723" "3724" "3725" "3726" "3727" "3728" "3729" "3730" "3731" "3732" "3733" "3734" "3735" "3736" "3737" "3738" "3739" "3740" "3741" "3742" "3743" "3744" "3745" "3746" "3747" "3748" "3749" "3750" "3751" "3752" "3753" "3754" "3755" "3756" "3757" "3758" "3759" "3760" "3761" "3762" "3763" "3764" "3765" "3766" "3767" "3768" "3769" "3770" "3771" "3772" "3773" "3774" "3775" "3776" "3777" "3778" "3779" "3780" "3781" "3782" "3783" "3784" "3785" "3786" "3787" "3788" "3789" "3790" "3791" "3792" "3793" "3794" "3795" "3796" "3797" "3798" "3799" "3800" "3801" "3802" "3803" "3804" "3805" "3806" "3807" "3808" "3809" "3810" "3811" "3812" "3813" "3814" "3815" "3816" "3817" "3818" "3819" "3820" "3821" "3822" "3823" "3824" "3825" "3826" "3827" "3828" "3829" "3830" "3831" "3832" "3833" "3834" "3835" "3836" "3837" "3838" "3839" "4011" "4111" "4112" "4119" "4121" "4131" "4214" "4215" "4225" "4411" "4457" "4468" "4511" "4582" "4722" "4723" "4784" "4789" "4812" "4813" "4814" "4815" "4816" "4821" "4829" "4899" "4900" "5013" "5021" "5039" "5044" "5045" "5046" "5047" "5051" "5065" "5072" "5074" "5085" "5094" "5099" "5111" "5122" "5131" "5137" "5139" "5169" "5172" "5192" "5193" "5198" "5199" "5200" "5211" "5231" "5251" "5261" "5262" "5271" "5292" "5293" "5300" "5309" "5310" "5311" "5331" "5399" "5411" "5422" "5441" "5451" "5462" "5499" "5511" "5521" "5531" "5532" "5533" "5541" "5542" "5551" "5552" "5561" "5571" "5592" "5598" "5599" "5611" "5621" "5631" "5641" "5651" "5655" "5661" "5681" "5691" "5697" "5698" "5699" "5712" "5713" "5714" "5715" "5718" "5719" "5722" "5723" "5732" "5733" "5734" "5735" "5811" "5812" "5813" "5814" "5815" "5816" "5817" "5818" "5912" "5921" "5931" "5932" "5933" "5935" "5937" "5940" "5941" "5942" "5943" "5944" "5945" "5946" "5947" "5948" "5949" "5950" "5960" "5962" "5963" "5964" "5965" "5966" "5967" "5968" "5969" "5970" "5971" "5972" "5973" "5975" "5976" "5977" "5978" "5983" "5992" "5993" "5994" "5995" "5996" "5997" "5998" "5999" "6010" "6011" "6012" "6050" "6051" "6211" "6300" "6513" "6520" "6532" "6533" "6536" "6537" "6538" "6540" "7011" "7012" "7032" "7033" "7210" "7211" "7216" "7217" "7221" "7230" "7251" "7261" "7273" "7276" "7277" "7278" "7295" "7296" "7297" "7298" "7299" "7311" "7321" "7322" "7333" "7338" "7339" "7342" "7349" "7361" "7372" "7375" "7379" "7392" "7393" "7394" "7395" "7399" "7512" "7513" "7519" "7523" "7531" "7534" "7535" "7538" "7542" "7549" "7622" "7623" "7629" "7631" "7641" "7692" "7699" "7800" "7801" "7802" "7829" "7832" "7841" "7911" "7922" "7929" "7932" "7933" "7941" "7991" "7992" "7993" "7994" "7995" "7996" "7997" "7998" "7999" "8011" "8021" "8031" "8041" "8042" "8043" "8049" "8050" "8062" "8071" "8099" "8111" "8211" "8220" "8241" "8244" "8249" "8299" "8351" "8398" "8641" "8651" "8661" "8675" "8699" "8734" "8911" "8931" "8999" "9211" "9222" "9223" "9311" "9399" "9402" "9405" "9406"  
 Example:  merchant_category_code=5411
customer_country
string (Country) ^[A-Za-z]{2}$
Country in ISO 3166-1 alpha-2 format.


 
 Example:  customer_country=US
currency
string (Currency) ^[A-Za-z]{3}$
Currency in ISO 4217 format.


Supported currencies:


    

  • AUD
    • 

  • EUR
    • 

  • CAD
    • 

  • CZK
    • 

  • DKK
    • 

  • HUF
    • 

  • MXN
    • 

  • NZD
    • 

  • NOK
    • 

  • PLN
    • 

  • RON
    • 

  • SEK
    • 

  • CHF
    • 

  • GBP
    • 

  • USD
    • 



 
 Example:  currency=USD
version
number (PaymentProgramsPlanVersionNumber) 
The version number of the payment program plan.


 
enablement_type
string (PaymentProgramEnablementType) 
The enablement type of the payment program.


    

  • PRESET - Indicates that the program is automatically enabled for the partner, and they cannot disable it themselves.
    • 

  • OPTIONAL - Partners can choose to enable or disable this program at their discretion.
    • 

  • RESTRICTED - Used for programs that are limited to specific partners, where only eligible partners may enable them.
    • 



 Enum: "PRESET" "OPTIONAL" "RESTRICTED"  
size
integer <int32> 
Limits the number of items to be returned. If omitted, the default page size will be used.


 
 Example:  size=20
starting_after
string
A cursor used in pagination, referring to a specific item. The last_item returned from a previous call can be used here. The next page will list items after this item. Cannot be used together with ending_before. If both starting_after and ending_before are omitted, the first page will be returned.


 
 Example:  starting_after=Zpq6F3mDYtwK8
ending_before
string
A cursor used in pagination, referring to a specific item. The first_item returned from a previous call can be used here. The next page will list items up until, but not including, this item. Cannot be used together with starting_after. If both starting_after and ending_before are omitted, the first page will be returned.


 
 Example:  ending_before=Zpq6F3mDYtwK8
Responses 
200
Payment programs list.


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/distribution/products/payment/payment-program-plans/{payment_program_plan_id}
Request samples 
Response samples 
application/json
{
  • "payment_program_plan_id": "krn:partner:global:payment:program:plan:33deb549-aa35-4102-b9ec-56c527386111",
  • "payment_programs": [
    ],
  • "version": 1,
  • "effective_from": "2024-01-01T12:00:00Z",
  • "comment": "Active, effective post Jan 1 2024",
  • "pagination": {
    }
}
Read a Payment Program
Read payment program details for a given payment program identifier.


Securityklarna_api_key 
Request 
path Parameters
payment_program_id
required
string (PaymentProgramIdentifier) 
Identifier of the payment program.


 
 Example:  krn:payment:global:payment:program:a5cd46f7e-573d-4b02-bab8-1f1c0e343291
Responses 
200
Payment program details.


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/distribution/products/payment/payment-programs/{payment_program_id}
Request samples 
Response samples 
application/json
{
  • "payment_program_id": "krn:payment:global:payment:program:a5cd46f7e-573d-4b02-bab8-1f1c0e343291",
  • "payment_program_name": "Financing - Interest Free",
  • "description": "Financing with a 0% Annual Percentage Rate (APR).",
  • "payment_funding": {
    }
}
List all Payment Programs for a Payment Product
List all payment programs for a payment product identifier.


Securityklarna_api_key 
Request 
path Parameters
product_id
required
string (PaymentProductIdentifier) 
Identifier of the payment product.


 
 Example:  krn:partner:global:payment-instance:test:3440b9b7-7ca2-44a3-8f62-776caacdaa0b
query Parameters
merchant_category_code
string (merchant-category.model_MerchantCategoryCode) 
The Merchant Category Code (MCC) is a four-digit number that is used to classify the type of goods or services
offered by a business.
[Read more here (https://docs.klarna.com/klarna-network-distribution/manage-partners/merchant-category-code)


 Enum: "0742" "0743" "0744" "0763" "0780" "1520" "1711" "1731" "1740" "1750" "1761" "1771" "1799" "2741" "2791" "2842" "3000" "3001" "3002" "3003" "3004" "3005" "3006" "3007" "3008" "3009" "3010" "3011" "3012" "3013" "3014" "3015" "3016" "3017" "3018" "3019" "3020" "3021" "3022" "3023" "3024" "3025" "3026" "3027" "3028" "3029" "3030" "3031" "3032" "3033" "3034" "3035" "3036" "3037" "3038" "3039" "3040" "3041" "3042" "3043" "3044" "3045" "3046" "3047" "3048" "3049" "3050" "3051" "3052" "3053" "3054" "3055" "3056" "3057" "3058" "3059" "3060" "3061" "3062" "3063" "3064" "3065" "3066" "3067" "3068" "3069" "3070" "3071" "3072" "3075" "3076" "3077" "3078" "3079" "3080" "3081" "3082" "3083" "3084" "3085" "3086" "3087" "3088" "3089" "3090" "3094" "3096" "3097" "3098" "3099" "3100" "3102" "3103" "3106" "3110" "3111" "3112" "3115" "3117" "3118" "3125" "3126" "3127" "3129" "3130" "3131" "3132" "3133" "3135" "3136" "3137" "3138" "3143" "3144" "3145" "3146" "3148" "3151" "3154" "3156" "3159" "3161" "3164" "3165" "3167" "3170" "3171" "3172" "3174" "3175" "3176" "3177" "3178" "3180" "3181" "3182" "3183" "3184" "3185" "3186" "3187" "3188" "3190" "3191" "3193" "3196" "3197" "3200" "3203" "3204" "3206" "3211" "3212" "3213" "3215" "3216" "3217" "3218" "3219" "3220" "3221" "3222" "3223" "3226" "3228" "3229" "3231" "3233" "3234" "3235" "3236" "3238" "3239" "3240" "3241" "3242" "3243" "3245" "3246" "3247" "3248" "3251" "3252" "3253" "3254" "3256" "3259" "3260" "3261" "3262" "3263" "3266" "3267" "3280" "3282" "3284" "3285" "3286" "3287" "3292" "3293" "3294" "3295" "3296" "3297" "3298" "3299" "3300" "3301" "3302" "3303" "3308" "3351" "3352" "3353" "3354" "3355" "3357" "3359" "3360" "3361" "3362" "3364" "3366" "3368" "3370" "3374" "3376" "3380" "3381" "3385" "3386" "3387" "3388" "3389" "3390" "3391" "3393" "3394" "3395" "3396" "3398" "3400" "3405" "3409" "3414" "3420" "3421" "3423" "3425" "3427" "3428" "3429" "3430" "3431" "3432" "3433" "3434" "3435" "3436" "3437" "3438" "3439" "3441" "3501" "3502" "3503" "3504" "3505" "3506" "3507" "3508" "3509" "3510" "3511" "3512" "3513" "3514" "3515" "3516" "3517" "3518" "3519" "3520" "3521" "3522" "3523" "3524" "3525" "3526" "3527" "3528" "3529" "3530" "3531" "3532" "3533" "3534" "3535" "3536" "3537" "3538" "3539" "3540" "3541" "3542" "3543" "3544" "3545" "3546" "3547" "3548" "3549" "3550" "3551" "3552" "3553" "3554" "3555" "3556" "3557" "3558" "3559" "3560" "3561" "3562" "3563" "3564" "3565" "3566" "3567" "3568" "3569" "3570" "3571" "3572" "3573" "3574" "3575" "3576" "3577" "3578" "3579" "3580" "3581" "3582" "3583" "3584" "3585" "3586" "3587" "3588" "3589" "3590" "3591" "3592" "3593" "3594" "3595" "3596" "3597" "3598" "3599" "3600" "3601" "3602" "3603" "3604" "3607" "3608" "3609" "3612" "3613" "3614" "3615" "3617" "3618" "3619" "3620" "3621" "3622" "3623" "3624" "3625" "3626" "3627" "3628" "3629" "3630" "3631" "3632" "3633" "3634" "3635" "3636" "3637" "3638" "3639" "3640" "3641" "3642" "3643" "3644" "3645" "3646" "3647" "3648" "3649" "3650" "3651" "3652" "3653" "3654" "3655" "3656" "3657" "3658" "3659" "3660" "3661" "3662" "3663" "3664" "3665" "3666" "3667" "3668" "3669" "3670" "3671" "3672" "3673" "3674" "3675" "3676" "3677" "3678" "3679" "3680" "3681" "3682" "3683" "3684" "3685" "3686" "3687" "3688" "3689" "3690" "3691" "3692" "3693" "3694" "3695" "3696" "3697" "3698" "3699" "3700" "3701" "3702" "3703" "3704" "3705" "3706" "3707" "3708" "3709" "3710" "3711" "3712" "3713" "3714" "3715" "3716" "3717" "3718" "3719" "3720" "3721" "3722" "3723" "3724" "3725" "3726" "3727" "3728" "3729" "3730" "3731" "3732" "3733" "3734" "3735" "3736" "3737" "3738" "3739" "3740" "3741" "3742" "3743" "3744" "3745" "3746" "3747" "3748" "3749" "3750" "3751" "3752" "3753" "3754" "3755" "3756" "3757" "3758" "3759" "3760" "3761" "3762" "3763" "3764" "3765" "3766" "3767" "3768" "3769" "3770" "3771" "3772" "3773" "3774" "3775" "3776" "3777" "3778" "3779" "3780" "3781" "3782" "3783" "3784" "3785" "3786" "3787" "3788" "3789" "3790" "3791" "3792" "3793" "3794" "3795" "3796" "3797" "3798" "3799" "3800" "3801" "3802" "3803" "3804" "3805" "3806" "3807" "3808" "3809" "3810" "3811" "3812" "3813" "3814" "3815" "3816" "3817" "3818" "3819" "3820" "3821" "3822" "3823" "3824" "3825" "3826" "3827" "3828" "3829" "3830" "3831" "3832" "3833" "3834" "3835" "3836" "3837" "3838" "3839" "4011" "4111" "4112" "4119" "4121" "4131" "4214" "4215" "4225" "4411" "4457" "4468" "4511" "4582" "4722" "4723" "4784" "4789" "4812" "4813" "4814" "4815" "4816" "4821" "4829" "4899" "4900" "5013" "5021" "5039" "5044" "5045" "5046" "5047" "5051" "5065" "5072" "5074" "5085" "5094" "5099" "5111" "5122" "5131" "5137" "5139" "5169" "5172" "5192" "5193" "5198" "5199" "5200" "5211" "5231" "5251" "5261" "5262" "5271" "5292" "5293" "5300" "5309" "5310" "5311" "5331" "5399" "5411" "5422" "5441" "5451" "5462" "5499" "5511" "5521" "5531" "5532" "5533" "5541" "5542" "5551" "5552" "5561" "5571" "5592" "5598" "5599" "5611" "5621" "5631" "5641" "5651" "5655" "5661" "5681" "5691" "5697" "5698" "5699" "5712" "5713" "5714" "5715" "5718" "5719" "5722" "5723" "5732" "5733" "5734" "5735" "5811" "5812" "5813" "5814" "5815" "5816" "5817" "5818" "5912" "5921" "5931" "5932" "5933" "5935" "5937" "5940" "5941" "5942" "5943" "5944" "5945" "5946" "5947" "5948" "5949" "5950" "5960" "5962" "5963" "5964" "5965" "5966" "5967" "5968" "5969" "5970" "5971" "5972" "5973" "5975" "5976" "5977" "5978" "5983" "5992" "5993" "5994" "5995" "5996" "5997" "5998" "5999" "6010" "6011" "6012" "6050" "6051" "6211" "6300" "6513" "6520" "6532" "6533" "6536" "6537" "6538" "6540" "7011" "7012" "7032" "7033" "7210" "7211" "7216" "7217" "7221" "7230" "7251" "7261" "7273" "7276" "7277" "7278" "7295" "7296" "7297" "7298" "7299" "7311" "7321" "7322" "7333" "7338" "7339" "7342" "7349" "7361" "7372" "7375" "7379" "7392" "7393" "7394" "7395" "7399" "7512" "7513" "7519" "7523" "7531" "7534" "7535" "7538" "7542" "7549" "7622" "7623" "7629" "7631" "7641" "7692" "7699" "7800" "7801" "7802" "7829" "7832" "7841" "7911" "7922" "7929" "7932" "7933" "7941" "7991" "7992" "7993" "7994" "7995" "7996" "7997" "7998" "7999" "8011" "8021" "8031" "8041" "8042" "8043" "8049" "8050" "8062" "8071" "8099" "8111" "8211" "8220" "8241" "8244" "8249" "8299" "8351" "8398" "8641" "8651" "8661" "8675" "8699" "8734" "8911" "8931" "8999" "9211" "9222" "9223" "9311" "9399" "9402" "9405" "9406"  
 Example:  merchant_category_code=5411
customer_country
string (Country) ^[A-Za-z]{2}$
Country in ISO 3166-1 alpha-2 format.


 
 Example:  customer_country=US
currency
string (Currency) ^[A-Za-z]{3}$
Currency in ISO 4217 format.


Supported currencies:


    

  • AUD
    • 

  • EUR
    • 

  • CAD
    • 

  • CZK
    • 

  • DKK
    • 

  • HUF
    • 

  • MXN
    • 

  • NZD
    • 

  • NOK
    • 

  • PLN
    • 

  • RON
    • 

  • SEK
    • 

  • CHF
    • 

  • GBP
    • 

  • USD
    • 



 
 Example:  currency=USD
enablement_type
string (PaymentProgramEnablementType) 
The enablement type of the payment program.


    

  • PRESET - Indicates that the program is automatically enabled for the partner, and they cannot disable it themselves.
    • 

  • OPTIONAL - Partners can choose to enable or disable this program at their discretion.
    • 

  • RESTRICTED - Used for programs that are limited to specific partners, where only eligible partners may enable them.
    • 



 Enum: "PRESET" "OPTIONAL" "RESTRICTED"  
Responses 
200
Payment programs list.


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/accounts/{account_id}/products/payment/{product_id}/payment-programs
Request samples 
Response samples 
application/json
{
  • "payment_programs": [
    ],
  • "pagination": {
    }
}
Create a Payment Program Enablement
Creates a payment program enablement on a payment product.


Securityklarna_api_key 
Request 
path Parameters
product_id
required
string (PaymentProductIdentifier) 
Identifier of the payment product.


 
 Example:  krn:partner:global:payment-instance:test:3440b9b7-7ca2-44a3-8f62-776caacdaa0b
Request Body schema: application/json
required
payment_program_id
required
string (PaymentProgramIdentifier) 
The identifier of the payment program.


 
required
object (EnablementCriteriaRequest) 
The enablement criteria of the payment program enablement.


 
effective_from
required
string <date-time>  (Timestamp) ^[0-9][0-9][0-9][0-9]-[0-1][0-9]-[0-3][0-9]T[...
Timestamp in ISO 8601 with timezone e.g. 2024-01-01T12:00:00Z


 
effective_to
required
string <date-time>  (Timestamp) ^[0-9][0-9][0-9][0-9]-[0-1][0-9]-[0-3][0-9]T[...
Timestamp in ISO 8601 with timezone e.g. 2024-01-01T12:00:00Z


 
Responses 
200
Payment program enablement created.


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


post/v2/accounts/{account_id}/products/payment/{product_id}/payment-program-enablements
Request samples 
application/json
{
  • "payment_program_id": "krn:payment:global:payment:program:a5cd46f7e-573d-4b02-bab8-1f1c0e343291",
  • "enablement_criteria": {
    },
  • "effective_from": "2024-01-01T12:00:00Z",
  • "effective_to": "2024-01-01T12:00:00Z"
}
Response samples 
application/json
{
  • "payment_program_enablement_id": "krn:partner:global:account:payment:program:enablement:4cfc200a-8f19-4d99-99cc-355bbd915e7b",
  • "payment_program_id": "krn:payment:global:payment:program:a5cd46f7e-573d-4b02-bab8-1f1c0e343291",
  • "enablement_criteria": {
    },
  • "effective_from": "2024-01-01T12:00:00Z",
  • "effective_to": "2024-01-01T12:00:00Z"
}
List all Payment Program Enablements
List all payment program enablements on a payment product.


Securityklarna_api_key 
Request 
path Parameters
product_id
required
string (PaymentProductIdentifier) 
Identifier of the payment product.


 
 Example:  krn:partner:global:payment-instance:test:3440b9b7-7ca2-44a3-8f62-776caacdaa0b
Responses 
200
Payment program enablements list.


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/accounts/{account_id}/products/payment/{product_id}/payment-program-enablements
Request samples 
Response samples 
application/json
{
  • "payment_program_enablements": [
    ]
}
Read a Payment Program Enablement
Read a payment program enablement for a given payment program enablement identifier.


Securityklarna_api_key 
Request 
path Parameters
product_id
required
string (PaymentProductIdentifier) 
Identifier of the payment product.


 
 Example:  krn:partner:global:payment-instance:test:3440b9b7-7ca2-44a3-8f62-776caacdaa0b
payment_product_enablement_id
required
string (PaymentProgramEnablementIdentifier) 
Identifier of the payment program enablement.


 
 Example:  krn:partner:global:payment:program:enablement:4b8b6350-6b72-42c5-b946-f088adcdc216
Responses 
200
Payment program enablement.


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


get/v2/accounts/{account_id}/products/payment/{product_id}/payment-program-enablements/{payment_program_enablement_id}
Request samples 
Response samples 
application/json
{
  • "payment_program_enablement_id": "krn:partner:global:account:payment:program:enablement:4cfc200a-8f19-4d99-99cc-355bbd915e7b",
  • "payment_program_id": "krn:payment:global:payment:program:a5cd46f7e-573d-4b02-bab8-1f1c0e343291",
  • "enablement_criteria": {
    },
  • "effective_from": "2024-01-01T12:00:00Z",
  • "effective_to": "2024-12-01T00:00:00Z"
}
Update a Payment Program Enablement
Update a payment program enablement for a given payment program enablement identifier. Can be used to set the payment program effective_to date.


Securityklarna_api_key 
Request 
path Parameters
product_id
required
string (PaymentProductIdentifier) 
Identifier of the payment product


 
 Example:  krn:partner:global:payment-instance:test:3440b9b7-7ca2-44a3-8f62-776caacdaa0b
payment_product_enablement_id
required
string (PaymentProgramEnablementIdentifier) 
Identifier of the payment program enablement


 
 Example:  krn:partner:global:payment:program:enablement:4b8b6350-6b72-42c5-b946-f088adcdc216
Request Body schema: application/json
required
object (EnablementCriteriaRequest) 
The enablement criteria of the payment program enablement.


 
effective_from
string <date-time>  (Timestamp) ^[0-9][0-9][0-9][0-9]-[0-1][0-9]-[0-3][0-9]T[...
Timestamp in ISO 8601 with timezone e.g. 2024-01-01T12:00:00Z


 
effective_to
string <date-time>  (Timestamp) ^[0-9][0-9][0-9][0-9]-[0-1][0-9]-[0-3][0-9]T[...
Timestamp in ISO 8601 with timezone e.g. 2024-01-01T12:00:00Z


 
Responses 
200
Payment program enablement updated


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


patch/v2/accounts/{account_id}/products/payment/{product_id}/payment-program-enablements/{payment_program_enablement_id}
Request samples 
application/json
{
  • "effective_to": "2024-12-01T00:00:00Z"
}
Response samples 
application/json
{
  • "payment_program_enablement_id": "krn:partner:global:account:payment:program:enablement:4cfc200a-8f19-4d99-99cc-355bbd915e7b",
  • "payment_program_id": "krn:payment:global:payment:program:a5cd46f7e-573d-4b02-bab8-1f1c0e343291",
  • "enablement_criteria": {
    },
  • "effective_from": "2024-01-01T12:00:00Z",
  • "effective_to": "2024-12-01T00:00:00Z"
}
Settlements
Downloads of Settlement reports for financial reconciliation.


Get settlement details
Get details about a specific settlement.


Securityklarna_api_key 
Request 
path Parameters
settlement_id
required
string (SettlementId) 
The id of settlement. For a payout it will be shown on the bank account statement.
Also used as the id of the payout in the Settlement API.


  Examples: 
113574395
XD65-113574395
Responses 
200
Ok


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


503
Service Temporarily Unavailable, the system is temporarily unavailable to process the request.


Callbacks 
postWebhook: Settlement report created
get/v2/settlement/settlements/{settlement_id}
Request samples 
Response samples 
application/json
{
  • "settlement_id": "12345",
  • "settling_business_entity_id": "krn:partner:global:settlement:settling-business-entity:K123455",
  • "created_at": "2024-10-13T00:00:00Z",
  • "period_from": "2024-10-05T00:00:00Z",
  • "period_to": "2024-10-12T00:00:00Z",
  • "settlement_amount": 200,
  • "currency": "USD",
  • "payout_id": "krn:partner:global:settlement:payout:fc3e914e-cd95-454e-8bb6-bf6bae4bc626",
  • "totals": {
    }
}
Callback payload samples 
POST: Webhook: Settlement report created
application/json
Webhook sent when a settlement report is available for download in the Settlements API


{
  • "metadata": {
    },
  • "payload": {}
}
Get settlement report (CSV)
Get the details of specific settlement in CSV format, also known as the Settlement Report.


The report consist of two sections: The summary section of two lines (heading + one data row)
then the transactions section (heading + n lines) starting on the third line.


Formatting details:


    

  • Delimiter: Comma ,
    • 

  • Values may be quoted using double quotes ".
    • 

  • Amounts are in minor currency units, $1.00 is represented as 100.
    • 

  • Amounts are signed, positive for credits, negative for debits.
    • 

  • Percentages are represented as an integers in minor units (e.g., 15.57% is represented as 1557).
    • 



All objects from the specification will be flattened out, delimited by a dot .. For example, payment_pricing.price_plan_id.


Securityklarna_api_key 
Request 
path Parameters
settlement_id
required
string (SettlementId) 
The id of settlement. For a payout it will be shown on the bank account statement.
Also used as the id of the payout in the Settlement API.


  Examples: 
113574395
XD65-113574395
Responses 
200
Ok


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


503
Service Temporarily Unavailable, the system is temporarily unavailable to process the request.


get/v2/settlement/settlements/{settlement_id}/csv
Request samples 
Response samples 
text/csv
# Totals section summing up the transactions in the file
settlement_id,settling_business_entity_id,created_at,period_from,period_to,settlement_amount,currency,capture_amount,refund_amount,payment_fixed_fee_amount,payment_variable_fee_amount,dispute_fee_amount,fee_correction_amount,chargeback_amount,correction_chargeback_amount,vat_amount,holdback_amount,release_amount,opening_debt_balance,deposit_amount,repay_amount,closing_debt_balance,payout_id,paid_out_at,payout_bank_account_id,payout_bank_account_reference,,,
15328742,krn:partner:global:settlement:settling-business-entity:252d81e9-23bd-4245-a74a-0fc3b382f211,2024-10-13T22:00:00Z,2024-10-05T22:00:00Z,2024-10-12T22:00:00Z,78743,EUR,174500,-17000,-900,-1224,-200,40,-76050,0,-423,0,0,0,0,0,0,krn:partner:global:settlement:payout:fc3e914e-cd95-454e-8bb6-bf6bae4bc626,2024-10-13T22:00:00Z,krn:partner:global:settlement-information:bank-account:56f77163-bc1b-46c8-a245-e251ff65e3d2,PSP US Bank Account,,,
# Transactions section
type,detailed_type,created_at,amount,currency,account_id,account_group_id,product_instance_id,settlement_id,settlement_configuration_id,payment_transaction_id,merchant_category_code,payment_transaction_created_at,payment_transaction_reference,payment_capture_id,payment_capture_reference,payment_refund_id,payment_refund_reference,payment_dispute_id,payment_chargeback_id,tax_amount,tax_rate,buy_rate_incentives_amount,sell_rate_incentives_amount,price_plan_id,payment_program_id,pricing_evaluated_at
# Capture on a payment transaction
SALE,CAPTURE,2024-09-10T09:53:25.000Z,15300,EUR,krn:partner:global:account:live:c0342d28-62b7-4d13-a685-840298a90d73,,krn:partner:product:payment:ad71bc48-8a07-4919-a2c1-103dba3fc918,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:6debe89e-98c0-486e-b7a5-08a4f6df94b0,5912,2024-09-07T15:25:04.000Z,partner-transaction-reference-4567,krn:payment:eu1:transaction:6debe89e-98c0-486e-b7a5-08a4f6df94b0:capture:1,partner-capture-ref-456,,,,,,,,,krn:partner:global:pricing:payments:price-plan:ad71bc48-8a07-4919-a2c1,krn:partner:global:pricing:payments:program:a5cd46f7e-573d-4b02-bab8-1f1c0e343291,2024-09-07T15:25:04.000Z
FEE,PAYMENT_FIXED_FEE,2024-09-10T09:53:26.250Z,-100,EUR,krn:partner:global:account:live:c0342d28-62b7-4d13-a685-840298a90d73,,krn:partner:product:payment:ad71bc48-8a07-4919-a2c1-103dba3fc918,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:6debe89e-98c0-486e-b7a5-08a4f6df94b0,5912,2024-09-07T15:25:04.000Z,partner-transaction-reference-4567,krn:payment:eu1:transaction:6debe89e-98c0-486e-b7a5-08a4f6df94b0:capture:1,partner-capture-ref-456,,,,,-19,1900,0,0,krn:partner:global:pricing:payments:price-plan:ad71bc48-8a07-4919-a2c1,krn:partner:global:pricing:payments:program:a5cd46f7e-573d-4b02-bab8-1f1c0e343291,2024-09-07T15:25:04.000Z
FEE,PAYMENT_VARIABLE_FEE,2024-09-10T09:53:26.250Z,-184,EUR,krn:partner:global:account:live:c0342d28-62b7-4d13-a685-840298a90d73,,krn:partner:product:payment:ad71bc48-8a07-4919-a2c1-103dba3fc918,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:6debe89e-98c0-486e-b7a5-08a4f6df94b0,5912,2024-09-07T15:25:04.000Z,partner-transaction-reference-4567,krn:payment:eu1:transaction:6debe89e-98c0-486e-b7a5-08a4f6df94b0:capture:1,partner-capture-ref-456,,,,,-35,1900,0,0,krn:partner:global:pricing:payments:price-plan:ad71bc48-8a07-4919-a2c1,krn:partner:global:pricing:payments:program:a5cd46f7e-573d-4b02-bab8-1f1c0e343291,2024-09-07T15:25:04.000Z
# Refund (partially) of above capture
REFUND,REFUND,2024-09-10T22:23:11.000Z,-800,EUR,krn:partner:global:account:live:c0342d28-62b7-4d13-a685-840298a90d73,,krn:partner:product:payment:ad71bc48-8a07-4919-a2c1-103dba3fc918,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:6debe89e-98c0-486e-b7a5-08a4f6df94b0,5912,2024-09-07T15:25:04.000Z,partner-transaction-reference-4567,krn:payment:eu1:transaction:6debe89e-98c0-486e-b7a5-08a4f6df94b0:capture:1,partner-capture-ref-456,krn:payment:eu1:transaction:6debe89e-98c0-486e-b7a5-08a4f6df94b0:refund:1,partner-refund-reference-123,,,,,,,krn:partner:global:pricing:payments:price-plan:ad71bc48-8a07-4919-a2c1,krn:partner:global:pricing:payments:program:a5cd46f7e-573d-4b02-bab8-1f1c0e343291,2024-09-07T15:25:04.000Z
# Capture on a payment transaction (for another merchant) with only fixed fee. The purchase is disputed and a dispute fee is applied.
SALE,CAPTURE,2024-09-09T09:22:25.000Z,17650,EUR,krn:partner:global:account:live:99d56935-fe56-4c5f-b64e-72e6ef61baec,,krn:partner:product:payment:c1b766ea-2007-4052-9571-8f8ae0012e14,15328742,krn:partner:global:settlement:settlement-configuration:ad8f5591-4caf-48b7-9fde-854d8df4390b,krn:payment:eu1:transaction:72223a37-7875-490f-ab43-78434214e9fb,7011,2024-09-08T09:53:25.000Z,partner-transaction-reference-1111,krn:payment:eu1:transaction:72223a37-7875-490f-ab43-78434214e9fb:capture:1,partner-capture-ref-888,,,,,,,,,krn:partner:global:pricing:payments:price-plan:ad71bc48-8a07-4919-a2c1,krn:partner:global:pricing:payments:program:a5cd46f7e-573d-4b02-bab8-1f1c0e343291,2024-09-08T09:53:25.000Z
FEE,PAYMENT_FIXED_FEE,2024-09-09T09:22:25.000Z,-100,EUR,krn:partner:global:account:live:99d56935-fe56-4c5f-b64e-72e6ef61baec,,krn:partner:product:payment:c1b766ea-2007-4052-9571-8f8ae0012e14,15328742,krn:partner:global:settlement:settlement-configuration:ad8f5591-4caf-48b7-9fde-854d8df4390b,krn:payment:eu1:transaction:72223a37-7875-490f-ab43-78434214e9fb,7011,2024-09-08T09:53:25.000Z,partner-transaction-reference-1111,krn:payment:eu1:transaction:72223a37-7875-490f-ab43-78434214e9fb:capture:1,partner-capture-ref-888,,,,,-20,2000,,,krn:partner:global:pricing:payments:price-plan:ad71bc48-8a07-4919-a2c1,krn:partner:global:pricing:payments:program:a5cd46f7e-573d-4b02-bab8-1f1c0e343291,2024-09-08T09:53:25.000Z
FEE,DISPUTE_FEE,2024-09-10T18:21:25.000Z,-200,EUR,krn:partner:global:account:live:99d56935-fe56-4c5f-b64e-72e6ef61baec,,krn:partner:product:payment:c1b766ea-2007-4052-9571-8f8ae0012e14,15328742,krn:partner:global:settlement:settlement-configuration:ad8f5591-4caf-48b7-9fde-854d8df4390b,krn:payment:eu1:transaction:72223a37-7875-490f-ab43-78434214e9fb,7011,2024-09-08T09:53:25.000Z,partner-transaction-reference-1111,krn:payment:eu1:transaction:72223a37-7875-490f-ab43-78434214e9fb:capture:1,partner-capture-ref-888,,,krn:payment:eu1:dispute:faulty-goods:256947,,,,,,,,
# Capture on a second payment transaction for above merchant. This time the complete purchase is chargebacked after a dispute is lost in favor of the consumer
SALE,CAPTURE,2024-09-09T14:21:05.000Z,17650,EUR,krn:partner:global:account:live:99d56935-fe56-4c5f-b64e-72e6ef61baec,,krn:partner:product:payment:c1b766ea-2007-4052-9571-8f8ae0012e14,15328742,krn:partner:global:settlement:settlement-configuration:ad8f5591-4caf-48b7-9fde-854d8df4390b,krn:payment:eu1:transaction:4a2aa077-4629-4efe-a75d-4e12a80ac55a,7011,2024-09-04T07:03:25.000Z,partner-transaction-reference-4545,krn:payment:eu1:transaction:4a2aa077-4629-4efe-a75d-4e12a80ac55a:capture:1,partner-capture-ref-578,,,,,,,,,krn:partner:global:pricing:payments:price-plan:ad71bc48-8a07-4919-a2c1,krn:partner:global:pricing:payments:program:a5cd46f7e-573d-4b02-bab8-1f1c0e343291,2024-09-04T07:03:25.000Z
FEE,PAYMENT_FIXED_FEE,2024-09-09T14:21:05.000Z,-100,EUR,krn:partner:global:account:live:99d56935-fe56-4c5f-b64e-72e6ef61baec,,krn:partner:product:payment:c1b766ea-2007-4052-9571-8f8ae0012e14,15328742,krn:partner:global:settlement:settlement-configuration:ad8f5591-4caf-48b7-9fde-854d8df4390b,krn:payment:eu1:transaction:4a2aa077-4629-4efe-a75d-4e12a80ac55a,7011,2024-09-04T07:03:25.000Z,partner-transaction-reference-4545,krn:payment:eu1:transaction:4a2aa077-4629-4efe-a75d-4e12a80ac55a:capture:1,partner-capture-ref-578,,,,,-24,2400,57,0,krn:partner:global:pricing:payments:price-plan:ad71bc48-8a07-4919-a2c1,krn:partner:global:pricing:payments:program:a5cd46f7e-573d-4b02-bab8-1f1c0e343291,2024-09-04T07:03:25.000Z
FEE,PAYMENT_VARIABLE_FEE,2024-09-09T14:21:05.000Z,-200,EUR,krn:partner:global:account:live:99d56935-fe56-4c5f-b64e-72e6ef61baec,,krn:partner:product:payment:c1b766ea-2007-4052-9571-8f8ae0012e14,15328742,krn:partner:global:settlement:settlement-configuration:ad8f5591-4caf-48b7-9fde-854d8df4390b,krn:payment:eu1:transaction:4a2aa077-4629-4efe-a75d-4e12a80ac55a,7011,2024-09-04T07:03:25.000Z,partner-transaction-reference-4545,krn:payment:eu1:transaction:4a2aa077-4629-4efe-a75d-4e12a80ac55a:capture:1,partner-capture-ref-578,,,,,-48,2400,69,0,,,
CHARGEBACK,CHARGEBACK,2024-09-10T22:15:25.000Z,-17650,EUR,krn:partner:global:account:live:99d56935-fe56-4c5f-b64e-72e6ef61baec,,krn:partner:product:payment:c1b766ea-2007-4052-9571-8f8ae0012e14,15328742,krn:partner:global:settlement:settlement-configuration:ad8f5591-4caf-48b7-9fde-854d8df4390b,krn:payment:eu1:transaction:4a2aa077-4629-4efe-a75d-4e12a80ac55a,7011,2024-09-04T07:03:25.000Z,partner-transaction-reference-4545,,,,,krn:payment:eu1:dispute:faulty-goods:53633,krn:payment:eu1:transaction:4a2aa077-4629-4efe-a75d-4e12a80ac55a:chargeback:1,,,,,,,
# A correction to a previously added variable fee
FEE_CORRECTION,CORRECTION_PAYMENT_VARIABLE_FEE,2024-09-10T09:53:26.250Z,40,EUR,krn:partner:global:account:live:55002546-6bc5-472f-b401-36c271f54464,,krn:partner:product:payment:559f156b-9939-4710-9a4b-2b25896650e3,15328742,krn:partner:global:settlement:settlement-configuration:ad8f5591-4caf-48b7-9fde-854d8df4390b,krn:payment:eu1:transaction:8bdaf94d-91bf-446e-aac1-82e55fed731e,5412,2024-09-10T09:53:25.000Z,partner-transaction-reference-33232,krn:payment:eu1:transaction:8bdaf94d-91bf-446e-aac1-82e55fed731e:capture:1,,,,,,9,2300,,,krn:partner:global:pricing:payments:price-plan:ad71bc48-8a07-4919-a2c1,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-10T09:53:25.000Z
# A payment transaction with two captures
SALE,CAPTURE,2024-09-09T12:55:25.000Z,8000,EUR,krn:partner:global:account:live:7d7713fc-43a2-40bd-baef-de444d85ac44,,krn:partner:product:payment:18af645c-9945-4a7f-a595-85a71d7c7664,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:16a484d1-859b-489f-8969-d92dccc7a3a0,5331,2024-09-01T05:27:57.512Z,partner-transaction-reference-874,krn:payment:eu1:transaction:16a484d1-859b-489f-8969-d92dccc7a3a0:capture:1,partner-capture-ref-100,,,,,,,,,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-01T05:27:57.512Z
FEE,PAYMENT_FIXED_FEE,2024-09-09T12:55:25.000Z,-100,EUR,krn:partner:global:account:live:7d7713fc-43a2-40bd-baef-de444d85ac44,,krn:partner:product:payment:18af645c-9945-4a7f-a595-85a71d7c7664,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:16a484d1-859b-489f-8969-d92dccc7a3a0,5331,2024-09-01T05:27:57.512Z,partner-transaction-reference-874,krn:payment:eu1:transaction:16a484d1-859b-489f-8969-d92dccc7a3a0:capture:1,partner-capture-ref-100,,,,,-19,1900,0,70,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-01T05:27:57.512Z
FEE,PAYMENT_VARIABLE_FEE,2024-09-09T12:55:25.000Z,-96,EUR,krn:partner:global:account:live:7d7713fc-43a2-40bd-baef-de444d85ac44,,krn:partner:product:payment:18af645c-9945-4a7f-a595-85a71d7c7664,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:16a484d1-859b-489f-8969-d92dccc7a3a0,5331,2024-09-01T05:27:57.512Z,partner-transaction-reference-874,krn:payment:eu1:transaction:16a484d1-859b-489f-8969-d92dccc7a3a0:capture:1,partner-capture-ref-100,,,,,-18,1900,0,59,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-01T05:27:57.512Z
SALE,CAPTURE,2024-09-09T22:47:36.000Z,4500,EUR,krn:partner:global:account:live:7d7713fc-43a2-40bd-baef-de444d85ac44,,krn:partner:product:payment:18af645c-9945-4a7f-a595-85a71d7c7664,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:16a484d1-859b-489f-8969-d92dccc7a3a0,5331,2024-09-01T05:27:57.512Z,partner-transaction-reference-874,krn:payment:eu1:transaction:16a484d1-859b-489f-8969-d92dccc7a3a0:capture:2,partner-capture-ref-200,,,,,,,,,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-01T05:27:57.512Z
FEE,PAYMENT_FIXED_FEE,2024-09-09T22:47:36.000Z,-100,EUR,krn:partner:global:account:live:7d7713fc-43a2-40bd-baef-de444d85ac44,,krn:partner:product:payment:18af645c-9945-4a7f-a595-85a71d7c7664,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:16a484d1-859b-489f-8969-d92dccc7a3a0,5331,2024-09-01T05:27:57.512Z,partner-transaction-reference-874,krn:payment:eu1:transaction:16a484d1-859b-489f-8969-d92dccc7a3a0:capture:2,partner-capture-ref-200,,,,,-19,1900,0,0,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-01T05:27:57.512Z
FEE,PAYMENT_VARIABLE_FEE,2024-09-09T22:47:36.000Z,-54,EUR,krn:partner:global:account:live:7d7713fc-43a2-40bd-baef-de444d85ac44,,krn:partner:product:payment:18af645c-9945-4a7f-a595-85a71d7c7664,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:16a484d1-859b-489f-8969-d92dccc7a3a0,5331,2024-09-01T05:27:57.512Z,partner-transaction-reference-874,krn:payment:eu1:transaction:16a484d1-859b-489f-8969-d92dccc7a3a0:capture:2,partner-capture-ref-200,,,,,-10,1900,0,0,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-01T05:27:57.512Z
# A payment transaction with two captures and one refund per capture
SALE,CAPTURE,2024-09-09T13:51:20.000Z,8000,EUR,krn:partner:global:account:live:7d7713fc-43a2-40bd-baef-de444d85ac44,,krn:partner:product:payment:2719962e-10ff-443a-a43b-1c6d0e07fbd9,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4,5412,2024-09-05T10:23:23.512Z,partner-transaction-reference-541,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4:capture:1,partner-capture-ref-999,,,,,,,,,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-05T10:23:23.512Z
FEE,PAYMENT_FIXED_FEE,2024-09-09T13:51:20.000Z,-100,EUR,krn:partner:global:account:live:7d7713fc-43a2-40bd-baef-de444d85ac44,,krn:partner:product:payment:2719962e-10ff-443a-a43b-1c6d0e07fbd9,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4,5412,2024-09-05T10:23:23.512Z,partner-transaction-reference-541,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4:capture:1,partner-capture-ref-999,,,,,-23,2300,0,70,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-05T10:23:23.512Z
FEE,PAYMENT_VARIABLE_FEE,2024-09-09T13:51:20.000Z,-96,EUR,krn:partner:global:account:live:7d7713fc-43a2-40bd-baef-de444d85ac44,,krn:partner:product:payment:2719962e-10ff-443a-a43b-1c6d0e07fbd9,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4,5412,2024-09-05T10:23:23.512Z,partner-transaction-reference-541,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4:capture:1,partner-capture-ref-999,,,,,-22,2300,0,59,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-05T10:23:23.512Z
SALE,CAPTURE,2024-09-09T17:11:32.000Z,4500,EUR,krn:partner:global:account:live:7d7713fc-43a2-40bd-baef-de444d85ac44,,krn:partner:product:payment:2719962e-10ff-443a-a43b-1c6d0e07fbd9,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4,5412,2024-09-05T10:23:23.512Z,partner-transaction-reference-541,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4:capture:2,partner-capture-ref-888,,,,,,,,,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-05T10:23:23.512Z
FEE,PAYMENT_FIXED_FEE,2024-09-09T17:11:32.000Z,-100,EUR,krn:partner:global:account:live:7d7713fc-43a2-40bd-baef-de444d85ac44,,krn:partner:product:payment:2719962e-10ff-443a-a43b-1c6d0e07fbd9,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4,5412,2024-09-05T10:23:23.512Z,partner-transaction-reference-541,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4:capture:2,partner-capture-ref-888,,,,,-23,2300,0,0,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-05T10:23:23.512Z
FEE,PAYMENT_VARIABLE_FEE,2024-09-09T17:11:32.000Z,-54,EUR,krn:partner:global:account:live:7d7713fc-43a2-40bd-baef-de444d85ac44,,krn:partner:product:payment:2719962e-10ff-443a-a43b-1c6d0e07fbd9,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4,5412,2024-09-05T10:23:23.512Z,partner-transaction-reference-541,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4:capture:2,partner-capture-ref-888,,,,,-12,2300,0,0,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-05T10:23:23.512Z
REFUND,REFUND,2024-09-10T21:20:21.000Z,-8000,EUR,krn:partner:global:account:live:7d7713fc-43a2-40bd-baef-de444d85ac44,,krn:partner:product:payment:2719962e-10ff-443a-a43b-1c6d0e07fbd9,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4,5412,2024-09-05T10:23:23.512Z,partner-transaction-reference-541,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4:capture:1,partner-capture-ref-999,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4:refund:1,partner-refund-reference-999,,,,,,,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-05T10:23:23.512Z
REFUND,REFUND,2024-09-10T21:20:21.000Z,-4500,EUR,krn:partner:global:account:live:7d7713fc-43a2-40bd-baef-de444d85ac44,,krn:partner:product:payment:2719962e-10ff-443a-a43b-1c6d0e07fbd9,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4,5412,2024-09-05T10:23:23.512Z,partner-transaction-reference-541,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4:capture:2,partner-capture-ref-888,krn:payment:eu1:transaction:1d85ff74-39a9-453e-9b6f-9a7808fa28c4:refund:2,partner-refund-reference-888,,,,,,,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-05T10:23:23.512Z
# A payment transaction that was refunded (not specifying capture)
SALE,CAPTURE,2024-09-09T14:51:20.000Z,45000,EUR,krn:partner:global:account:live:c0342d28-62b7-4d13-a685-840298a90d73,,krn:partner:product:payment:bde34d74-20fa-4171-a1e9-11d2e398734d,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:4be3768f-e4a3-470d-98e1-645749f72779,7011,2024-09-05T10:24:23.512Z,partner-transaction-reference-pow,krn:payment:eu1:transaction:4be3768f-e4a3-470d-98e1-645749f72779:capture:1,partner-capture-ref-pow,,,,,,,,,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-05T10:24:23.512Z
FEE,PAYMENT_FIXED_FEE,2024-09-09T14:51:20.000Z,-100,EUR,krn:partner:global:account:live:c0342d28-62b7-4d13-a685-840298a90d73,,krn:partner:product:payment:bde34d74-20fa-4171-a1e9-11d2e398734d,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:4be3768f-e4a3-470d-98e1-645749f72779,7011,2024-09-05T10:24:23.512Z,partner-transaction-reference-pow,krn:payment:eu1:transaction:4be3768f-e4a3-470d-98e1-645749f72779:capture:1,partner-capture-ref-pow,,,,,-19,1900,0,70,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-05T10:24:23.512Z
FEE,PAYMENT_VARIABLE_FEE,2024-09-09T14:51:20.000Z,-540,EUR,krn:partner:global:account:live:c0342d28-62b7-4d13-a685-840298a90d73,,krn:partner:product:payment:bde34d74-20fa-4171-a1e9-11d2e398734d,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:4be3768f-e4a3-470d-98e1-645749f72779,7011,2024-09-05T10:24:23.512Z,partner-transaction-reference-pow,krn:payment:eu1:transaction:4be3768f-e4a3-470d-98e1-645749f72779:capture:1,partner-capture-ref-pow,,,,,-103,1900,0,59,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-05T10:24:23.512Z
REFUND,REFUND,2024-09-10T22:20:21.000Z,-3700,EUR,krn:partner:global:account:live:c0342d28-62b7-4d13-a685-840298a90d73,,krn:partner:product:payment:bde34d74-20fa-4171-a1e9-11d2e398734d,15328742,krn:partner:global:settlement:settlement-configuration:e54eb4c7-5370-47c4-b6db-3a6471e09629,krn:payment:eu1:transaction:4be3768f-e4a3-470d-98e1-645749f72779,7011,2024-09-05T10:24:23.512Z,partner-transaction-reference-1478,,,krn:payment:eu1:transaction:4be3768f-e4a3-470d-98e1-645749f72779:refund:1,partner-refund-reference-pow,,,,,,,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-05T10:24:23.512Z
# A capture that is chargbacked due to customer payment defualt
SALE,CAPTURE,2024-09-09T13:51:20.000Z,58400,EUR,krn:partner:global:account:live:ba251a3c-314d-4551-a282-c4e1e5d94353,,krn:partner:product:payment:c0981a4c-fadc-4718-96db-f639f9a18cac,15328742,krn:partner:global:settlement:settlement-configuration:ad8f5591-4caf-48b7-9fde-854d8df4390b,krn:payment:eu1:transaction:169dafea-394e-48be-8418-363fcb2f06b6,7011,2024-09-01T08:03:25.000Z,partner-transaction-reference-4545,krn:payment:eu1:transaction:169dafea-394e-48be-8418-363fcb2f06b6:capture:1,partner-capture-ref-555,,,,,,,,,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-01T08:03:25.000Z
FEE,PAYMENT_FIXED_FEE,2024-09-09T13:51:20.000Z,-100,EUR,krn:partner:global:account:live:ba251a3c-314d-4551-a282-c4e1e5d94353,,krn:partner:product:payment:c0981a4c-fadc-4718-96db-f639f9a18cac,15328742,krn:partner:global:settlement:settlement-configuration:ad8f5591-4caf-48b7-9fde-854d8df4390b,krn:payment:eu1:transaction:169dafea-394e-48be-8418-363fcb2f06b6,7011,2024-09-01T08:03:25.000Z,partner-transaction-reference-4545,krn:payment:eu1:transaction:169dafea-394e-48be-8418-363fcb2f06b6:capture:1,partner-capture-ref-555,,,,,-23,2300,0,70,krn:partner:global:pricing:payments:price-plan:baff081e-c246-4ba1-ad94-e4f913a77a34,krn:partner:global:pricing:payments:program:6bda01c4-ee39-4aec-a160-f2a7fa3ce90d,2024-09-01T08:03:25.000Z
CHARGEBACK,CUSTOMER_PAYMENT_DEFAULT,2024-09-09T05:51:21.000Z,-58400,EUR,krn:partner:global:account:live:ba251a3c-314d-4551-a282-c4e1e5d94353,,krn:partner:product:payment:c0981a4c-fadc-4718-96db-f639f9a18cac,15328742,krn:partner:global:settlement:settlement-configuration:ad8f5591-4caf-48b7-9fde-854d8df4390b,krn:payment:eu1:transaction:169dafea-394e-48be-8418-363fcb2f06b6,7011,2024-09-01T08:03:25.000Z,partner-transaction-reference-4545,,,,,,krn:payment:eu1:transaction:169dafea-394e-48be-8418-363fcb2f06b6::chargeback:1,,,,,,,

List settlement transactions
Lists all transactions for a specific settlement.


Securityklarna_api_key 
Request 
path Parameters
settlement_id
required
string (SettlementId) 
The id of settlement. For a payout it will be shown on the bank account statement.
Also used as the id of the payout in the Settlement API.


  Examples: 
113574395
XD65-113574395
query Parameters
size
integer <int32> 
Limits the number of items to be returned. If omitted, the default page size will be used.


 
 Example:  size=20
starting_after
string
A cursor used in pagination, referring to a specific item. The last_item returned from a previous call can be used here. The next page will list items after this item. Cannot be used together with ending_before. If both starting_after and ending_before are omitted, the first page will be returned.


 
 Example:  starting_after=Zpq6F3mDYtwK8
ending_before
string
A cursor used in pagination, referring to a specific item. The first_item returned from a previous call can be used here. The next page will list items up until, but not including, this item. Cannot be used together with starting_after. If both starting_after and ending_before are omitted, the first page will be returned.


 
 Example:  ending_before=Zpq6F3mDYtwK8
Responses 
200
Ok


400
Bad Request, there was an error in the input of the request.
The request can not be retried without modifications.


401
Unauthorized, the request was not authorized.


404
Not Found, the requested resource was not found.


429
Too Many Requests, the request was rate limited.


500
Internal Server Error, there was an unexpected error in the API.


503
Service Temporarily Unavailable, the system is temporarily unavailable to process the request.


get/v2/settlement/settlements/{settlement_id}/transactions
Request samples 
Response samples 
application/json
{
  • "transactions": [
    ],
  • "pagination": {}
}
Cookies
Terms of Service
© Klarna 2024