Create order for manual authorization

Manual authorization requires a separate authorization call after buyer approval and provides more control over the payment process. Create orders for manual authorization using two available flows.

Single-step flow: Include payment source details directly in the create order request for a streamlined integration
Multi-step flow: Create the order first, then add payment source details in a separate step for more flexibility

Single-step flow

Use a valid access token and send a POST request /v2/checkout/orders with request body parameters including intent, purchase_units with amount and currency, payment_source with Klarna details.

On successful order creation, complete the Klarna payment with these steps:

Review order response: PayPal returns order ID with PAYER_ACTION_REQUIRED status and payer-action link
Redirect your buyer: Send the buyer to the payer-action URL to complete payment on Klarna's platform
Monitor payment status: Buyer approves payment and order status changes to APPROVED
Authorize the payment: Call the authorize payment endpoint to complete manual authorization
Capture the payment: Send POST request to /v2/payments/authorizations/{authorization_id}/capture with the authorization ID from the authorization response
Notify the buyer: Send order confirmation to the buyer

curl -X POST https://api.sandbox.paypal.com/v2/checkout/orders \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <ACCESS-TOKEN>' \
  -H 'PayPal-Request-Id: <REQUEST-ID>' \
  -d '{
    "intent": "AUTHORIZE",
    "purchase_units": [
        {
            "payee": {
                "merchant_id": "YR8FPJ7TDVD6A"
            },
            "amount": {
                "currency_code": "GBP",
                "value": 30,
                "breakdown": {
                    "item_total": {
                        "currency_code": "GBP",
                        "value": 30
                    },
                    "shipping": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "handling": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "tax_total": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "shipping_discount": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    }
                }
            },
            "items": [
                {
                    "name": "jersey",
                    "description": "jersey",
                    "sku": "",
                    "unit_amount": {
                        "currency_code": "GBP",
                        "value": "15.00"
                    },
                    "tax": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "category": "PHYSICAL_GOODS",
                    "quantity": "1"
                },
                {
                    "name": "jersey",
                    "description": "jersey",
                    "sku": "",
                    "unit_amount": {
                        "currency_code": "GBP",
                        "value": "15.00"
                    },
                    "tax": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "category": "PHYSICAL_GOODS",
                    "quantity": "1"
                }
            ]
        }
    ],
    "payment_source": {
        "klarna": {
            "authorization_context": {
                "authorization_expiry": "2025-09-29T23:37:39Z"
            },
            "country_code": "GB",
            "billing_address": {
                "address_line_1": "10 New Burlington Street",
                "admin_area_2": "London",
                "admin_area_1": "Greater London",
                "postal_code": "W1S 3BE",
                "country_code": "GB"
            },
            "name": {
                "given_name": "Test",
                "surname": "Person-uk"
            },
            "email_address": "[email protected]",
            "phone": {
                "national_number": "7755564318",
                "country_code": "44"
            },
            "experience_context": {
                "locale": "en-GB",
                "acquiring_channel": "ECOMMERCE",
                "return_url": "https://www.example.com/returnUrl",
                "cancel_url": "https://www.example.com/cancelUrl"
            }
        }
    },
    "application_context": {
        "client_configuration": {
            "api": "ORDERS_V2",
            "experience": {
                "entry_point": "PAY_WITH_ALTPAY_KLARNA",
                "payment_method": "PAY_WITH_ALTPAY_KLARNA"
            }
        }
    }
  }'

Multi-step flow

Use a valid access token and send a POST request to /v2/checkout/orders with request body parameters including intent, purchase_units with amount and currency, and the PayPal-Request-Id header for idempotency.

On successful order creation, complete the Klarna payment with these steps:

Review order response: PayPal returns order ID with CREATED status and approve link
Add payment source details: Choose one of two options:
- Send POST request to /v2/checkout/orders/{order_id}/confirm-payment-source with complete payment_source.klarna object
- Include payment source details in the authorization call (step 4)
Redirect your buyer: Send the buyer to the approve URL to complete payment approval
Monitor payment status: Buyer approves payment and order status changes to APPROVED
Authorize the payment: Call the authorize payment endpoint to complete manual authorization
Capture the payment: Send POST request to /v2/payments/authorizations/{authorization_id}/capture with the authorization ID from the authorization response
Notify the buyer: Send order confirmation to the buyer

Note: Payment source details can be provided during order confirmation or authorization - choose the method that best fits your checkout flow.

curl -X POST https://api.sandbox.paypal.com/v2/checkout/orders \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <ACCESS-TOKEN>' \
  -H 'PayPal-Request-Id: <REQUEST-ID>' \
  -d '{
    "intent": "AUTHORIZE",
    "purchase_units": [
        {
            "payee": {
                "merchant_id": "YR8FPJ7TDVD6A"
            },
            "amount": {
                "currency_code": "GBP",
                "value": 30,
                "breakdown": {
                    "item_total": {
                        "currency_code": "GBP",
                        "value": 30
                    },
                    "shipping": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "handling": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "tax_total": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "shipping_discount": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    }
                }
            },
            "items": [
                {
                    "name": "jersey",
                    "description": "jersey",
                    "sku": "",
                    "unit_amount": {
                        "currency_code": "GBP",
                        "value": "15.00"
                    },
                    "tax": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "category": "PHYSICAL_GOODS",
                    "quantity": "1"
                },
                {
                    "name": "jersey",
                    "description": "jersey",
                    "sku": "",
                    "unit_amount": {
                        "currency_code": "GBP",
                        "value": "15.00"
                    },
                    "tax": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "category": "PHYSICAL_GOODS",
                    "quantity": "1"
                }
            ]
        }
    ],
    "application_context": {
        "client_configuration": {
            "api": "ORDERS_V2",
            "experience": {
                "entry_point": "PAY_WITH_ALTPAY_KLARNA",
                "payment_method": "PAY_WITH_ALTPAY_KLARNA"
            }
        }
    }
  }'

Parameter name, Description
Parameter name	Description
`intent` Required, string	Indicates whether payment is captured immediately or authorized for later capture. For Klarna payments, set to `AUTHORIZE`.
`processing_instruction` string	Specifies how the order is processed. For manual authorization flow, exclude this parameter or set to `NO_INSTRUCTION`.
`purchase_units` Required, array	Lists the items or services the buyer is purchasing in the order.
`purchase_units.amount` Required, object	Amount of the order and the currency code. For supported currencies, see Supported countries and currencies.
`payment_source` object	Payment method used to fund the order. For Klarna payments, include a klarna object with buyer and experience context information.
`payment_source.klarna.authorization_context` object	Payment authorization settings with expiration time.
`payment_source.klarna.authorization_context.expiration_time` string	Timestamp of when the authorization expires, specified in UTC format.
`payment_source.klarna.country_code` Required, object	Country where the buyer is located. Use 2-character ISO 3166-1 alpha-2 country code.
`payment_source.klarna.name.given_name` Required, object	Buyer's first name.
`payment_source.klarna.name.surname` Required, object	Buyer's last name.
`payment_source.klarna.billing_address` Required, object	Buyer's billing address information including address lines, city, state, postal code, and country.
`payment_source.klarna.experience_context` Required, object	Context information for the Klarna payment experience including locale, intent, and acquiring channel.
`payment_source.klarna.experience_context.locale` Required, object	Locale for the Klarna payment experience. For example, `en-GB`, `en-US`.
`application_context` object	Application context for the order. Customizes the buyer experience during the approval process.
`application_context.return_url` string	URL to redirect the buyer after they approve the payment.
`application_context.cancel_url` string	URL to redirect the buyer if they cancel the approval.

Single-step flow

On successful order creation, complete the Klarna payment with these steps:

Review order response: PayPal returns order ID with PAYER_ACTION_REQUIRED status and payer-action link

Redirect your buyer: Send the buyer to the payer-action URL to complete payment on Klarna's platform

Monitor payment status: Buyer approves payment and order status changes to APPROVED

Authorize the payment: Call the authorize payment endpoint to complete manual authorization

Capture the payment: Send POST request to /v2/payments/authorizations/{authorization_id}/capture with the authorization ID from the authorization response

Notify the buyer: Send order confirmation to the buyer

curl -X POST https://api.sandbox.paypal.com/v2/checkout/orders \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <ACCESS-TOKEN>' \
  -H 'PayPal-Request-Id: <REQUEST-ID>' \
  -d '{
    "intent": "AUTHORIZE",
    "purchase_units": [
        {
            "payee": {
                "merchant_id": "YR8FPJ7TDVD6A"
            },
            "amount": {
                "currency_code": "GBP",
                "value": 30,
                "breakdown": {
                    "item_total": {
                        "currency_code": "GBP",
                        "value": 30
                    },
                    "shipping": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "handling": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "tax_total": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "shipping_discount": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    }
                }
            },
            "items": [
                {
                    "name": "jersey",
                    "description": "jersey",
                    "sku": "",
                    "unit_amount": {
                        "currency_code": "GBP",
                        "value": "15.00"
                    },
                    "tax": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "category": "PHYSICAL_GOODS",
                    "quantity": "1"
                },
                {
                    "name": "jersey",
                    "description": "jersey",
                    "sku": "",
                    "unit_amount": {
                        "currency_code": "GBP",
                        "value": "15.00"
                    },
                    "tax": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "category": "PHYSICAL_GOODS",
                    "quantity": "1"
                }
            ]
        }
    ],
    "payment_source": {
        "klarna": {
            "authorization_context": {
                "authorization_expiry": "2025-09-29T23:37:39Z"
            },
            "country_code": "GB",
            "billing_address": {
                "address_line_1": "10 New Burlington Street",
                "admin_area_2": "London",
                "admin_area_1": "Greater London",
                "postal_code": "W1S 3BE",
                "country_code": "GB"
            },
            "name": {
                "given_name": "Test",
                "surname": "Person-uk"
            },
            "email_address": "[email protected]",
            "phone": {
                "national_number": "7755564318",
                "country_code": "44"
            },
            "experience_context": {
                "locale": "en-GB",
                "acquiring_channel": "ECOMMERCE",
                "return_url": "https://www.example.com/returnUrl",
                "cancel_url": "https://www.example.com/cancelUrl"
            }
        }
    },
    "application_context": {
        "client_configuration": {
            "api": "ORDERS_V2",
            "experience": {
                "entry_point": "PAY_WITH_ALTPAY_KLARNA",
                "payment_method": "PAY_WITH_ALTPAY_KLARNA"
            }
        }
    }
  }'

Multi-step flow

On successful order creation, complete the Klarna payment with these steps:

Review order response: PayPal returns order ID with CREATED status and approve link
Add payment source details: Choose one of two options:
- Send POST request to /v2/checkout/orders/{order_id}/confirm-payment-source with complete payment_source.klarna object
- Include payment source details in the authorization call (step 4)
Redirect your buyer: Send the buyer to the approve URL to complete payment approval
Monitor payment status: Buyer approves payment and order status changes to APPROVED
Authorize the payment: Call the authorize payment endpoint to complete manual authorization
Capture the payment: Send POST request to /v2/payments/authorizations/{authorization_id}/capture with the authorization ID from the authorization response
Notify the buyer: Send order confirmation to the buyer

Note: Payment source details can be provided during order confirmation or authorization - choose the method that best fits your checkout flow.

curl -X POST https://api.sandbox.paypal.com/v2/checkout/orders \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <ACCESS-TOKEN>' \
  -H 'PayPal-Request-Id: <REQUEST-ID>' \
  -d '{
    "intent": "AUTHORIZE",
    "purchase_units": [
        {
            "payee": {
                "merchant_id": "YR8FPJ7TDVD6A"
            },
            "amount": {
                "currency_code": "GBP",
                "value": 30,
                "breakdown": {
                    "item_total": {
                        "currency_code": "GBP",
                        "value": 30
                    },
                    "shipping": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "handling": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "tax_total": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "shipping_discount": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    }
                }
            },
            "items": [
                {
                    "name": "jersey",
                    "description": "jersey",
                    "sku": "",
                    "unit_amount": {
                        "currency_code": "GBP",
                        "value": "15.00"
                    },
                    "tax": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "category": "PHYSICAL_GOODS",
                    "quantity": "1"
                },
                {
                    "name": "jersey",
                    "description": "jersey",
                    "sku": "",
                    "unit_amount": {
                        "currency_code": "GBP",
                        "value": "15.00"
                    },
                    "tax": {
                        "currency_code": "GBP",
                        "value": "0.00"
                    },
                    "category": "PHYSICAL_GOODS",
                    "quantity": "1"
                }
            ]
        }
    ],
    "application_context": {
        "client_configuration": {
            "api": "ORDERS_V2",
            "experience": {
                "entry_point": "PAY_WITH_ALTPAY_KLARNA",
                "payment_method": "PAY_WITH_ALTPAY_KLARNA"
            }
        }
    }
  }'

Parameter name

Description

intent
Required, string

Indicates whether payment is captured immediately or authorized for later capture. For Klarna payments, set to AUTHORIZE.

processing_instruction
string

Specifies how the order is processed.

For manual authorization flow, exclude this parameter or set to NO_INSTRUCTION.

purchase_units
Required, array

Lists the items or services the buyer is purchasing in the order.

purchase_units.amount
Required, object

Amount of the order and the currency code.

For supported currencies, see Supported countries and currencies.

payment_source
object

Payment method used to fund the order. For Klarna payments, include a klarna object with buyer and experience context information.

payment_source.klarna.authorization_context
object

Payment authorization settings with expiration time.

payment_source.klarna.authorization_context.expiration_time
string

Timestamp of when the authorization expires, specified in UTC format.

payment_source.klarna.country_code
Required, object

Country where the buyer is located. Use 2-character ISO 3166-1 alpha-2 country code.

payment_source.klarna.name.given_name
Required, object

Buyer's first name.

payment_source.klarna.name.surname
Required, object

Buyer's last name.

payment_source.klarna.billing_address
Required, object

Buyer's billing address information including address lines, city, state, postal code, and country.

payment_source.klarna.experience_context
Required, object

Context information for the Klarna payment experience including locale, intent, and acquiring channel.

payment_source.klarna.experience_context.locale
Required, object

Locale for the Klarna payment experience. For example, en-GB, en-US.

application_context
object

Application context for the order. Customizes the buyer experience during the approval process.

application_context.return_url
string

URL to redirect the buyer after they approve the payment.

application_context.cancel_url
string

URL to redirect the buyer if they cancel the approval.

Create order for manual authorization

Single-step flow

Multi-step flow

On this page

On this page

On this page

Create order for manual authorization

Single-step flow

Multi-step flow

On this page

On this page

Create order for manual authorization

Single-step flow

Multi-step flow

On this page

On this page

On this page

If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more

Create order for manual authorization

Single-step flow

Multi-step flow

On this page

On this page