Authorize order with payment

After buyer approval, authorize the order with Klarna as the payment source to finalize the payment through PayPal and make it ready for capture. This step is specific to the manual authorization flow.

Before authorizing, verify that the buyer has completed approval by checking if the order status is APPROVED. You can track the status in two ways:

Poll for updates: Call GET /v2/checkout/orders/{order_id} until status changes from PAYER_ACTION_REQUIRED to APPROVED.
Use webhooks: Subscribe to CHECKOUT.ORDER.APPROVED webhook for immediate notification.

After the order status is APPROVED, use a valid access token and send a POST request to /v2/checkout/orders/{order_id}/authorize.

curl -X POST https://api.sandbox.paypal.com/v2/checkout/orders/5O190127TN364715T/authorize \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "PayPal-Request-Id: <UNIQUE_REQUEST_ID>" \
  -d '{
    "payment_source": {
        "klarna": {
            "authorization_context": {
                "expiration_time": "2023-10-08T23:37:39Z"
            },
            "country_code": "UK",
            "billing_address": {
                "address_line_1": "Schönhauser Allee 84",
                "admin_area_2": "London",
                "admin_area_1": "Province",
                "postal_code": "10439",
                "country_code": "UK"
            },
            "name": {
                "given_name": "John",
                "surname": "Doe"
            },
            "email": "[email protected]",
            "phone": {
                "national_number": "6912345678",
                "country_code": "49"
            },
            "experience_context": {
                "locale": "en-UK",
                "intent": "buy",
                "acquiring_channel": "ECOMMERCE"
            }
        }
    }
}'

Parameter name, Description
Parameter name	Description
`payment_source.klarna` object	Klarna payment source information including buyer details and authorization settings.
`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,string	Country code required for Klarna payments, specified in the ISO 3166-1 format.
`payment_source.klarna.name` Required,object	Name of the buyer.
`payment_source.klarna.name.given_name` Required,string	First name of the buyer.
`payment_source.klarna.name.surname` string	Last name of the buyer
`payment_source.klarna.email` Required,string	Email address of the buyer.
`payment_source.klarna.phone` object	Details of the buyer's phone number.
`payment_source.klarna.experience_context` object	Experience context for the payment.
`payment_source.klarna.experience_context.locale` Required,object	Locale code for the buyer's language and region preference.

Authorize order with payment

Before authorizing, verify that the buyer has completed approval by checking if the order status is APPROVED. You can track the status in two ways:

Poll for updates: Call GET /v2/checkout/orders/{order_id} until status changes from PAYER_ACTION_REQUIRED to APPROVED.
Use webhooks: Subscribe to CHECKOUT.ORDER.APPROVED webhook for immediate notification.

After the order status is APPROVED, use a valid access token and send a POST request to /v2/checkout/orders/{order_id}/authorize.

curl -X POST https://api.sandbox.paypal.com/v2/checkout/orders/5O190127TN364715T/authorize \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "PayPal-Request-Id: <UNIQUE_REQUEST_ID>" \
  -d '{
    "payment_source": {
        "klarna": {
            "authorization_context": {
                "expiration_time": "2023-10-08T23:37:39Z"
            },
            "country_code": "UK",
            "billing_address": {
                "address_line_1": "Schönhauser Allee 84",
                "admin_area_2": "London",
                "admin_area_1": "Province",
                "postal_code": "10439",
                "country_code": "UK"
            },
            "name": {
                "given_name": "John",
                "surname": "Doe"
            },
            "email": "[email protected]",
            "phone": {
                "national_number": "6912345678",
                "country_code": "49"
            },
            "experience_context": {
                "locale": "en-UK",
                "intent": "buy",
                "acquiring_channel": "ECOMMERCE"
            }
        }
    }
}'

Parameter name, Description
Parameter name	Description
`payment_source.klarna` object	Klarna payment source information including buyer details and authorization settings.
`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,string	Country code required for Klarna payments, specified in the ISO 3166-1 format.
`payment_source.klarna.name` Required,object	Name of the buyer.
`payment_source.klarna.name.given_name` Required,string	First name of the buyer.
`payment_source.klarna.name.surname` string	Last name of the buyer
`payment_source.klarna.email` Required,string	Email address of the buyer.
`payment_source.klarna.phone` object	Details of the buyer's phone number.
`payment_source.klarna.experience_context` object	Experience context for the payment.
`payment_source.klarna.experience_context.locale` Required,object	Locale code for the buyer's language and region preference.

Authorize order with payment