Skip to main content

Overview​

Users only need to complete Klarna authorization during the initial subscription. Subsequent recurring charges will be automatically deducted from the user’s account, with no additional redirects or secondary confirmations required.

How It Works​

  1. Set Request Headers:
'Content-Type:application/json',
'account:995149',
'terminal:99514901',
'secureCode:12345678'
  1. Call Oceanpayment to create a QuickPay ID, submitting the required parameters, methods = 'Klarna'.
cURL -X POST 'https://checkout-s.oceanpayment.com/pg/quickPay/create' \
-d 
{
    "order": {
        "currency": "USD",
        "amount": "0.1",
        "methods": "Klarna",
        "redirectUrl": "http://www.abc.com/result.php",
        "notifyUrl": "http://www.abc.com/notice.php",
        "remark": "",
        "ip": "127.0.0.1",
        "description": ""
    },
    "merchant": {
        "referenceId": "test20250116094234"
    },
    "billing": {
        "firstname": "firstName",
        "lastname": "lastName",
        "email": "test@op.com",
        "phone": "13800138000",
        "country": "US",
        "state": "state",
        "city": "city",
        "address": "address",
        "zip": "518000"
    },
    "customer": {
        "id": "test20250116094234"
    },
    "device": {
        "environment": "",
        "osType": ""
    },
    "subscription"{
    	"name": "",
    	"interval": "1",
    	"intervalCount": "1",  
    },   
    "customer_info": "{}",
    "voucher_info": "{}" 
}

Handling the Response​

  1. url: The redirect URL. Merchants must redirect the user’s browser to this URL, where the user completes authorization on the frontend.
  • When url is not empty：A page redirect is required. The user completes authorization on the frontend, and the result of the QuickPay ID creation is returned after authorization (delivered via redirectUrl, using POST by default).
  • When url is empty：The response data directly contains the result of the QuickPay ID creation.
{
    "msg": "SUCCESS",
    "code": "000",
    "data": {
        "account": "995149",
        "terminal": "99514901",
        "order": {
            "methods": "Klarna",
            "referenceId": "250117093828061010584",
            "remark": "",
            "description": ""
        },
        "url": "https://checkout.oceanpayment.com/bank/quickPay/create?opRefId=250117093828061010584",
        "merchant": {
            "referenceId": "test20250117093730"
        }
    }
}
  • The merchant redirects the user to the url to complete the creation process.
HTTP/1.2 301 Moved Permanently
Location: {url}
  • Use the redirectUrl parameter to receive the result of the QuickPay ID creation:
Array
(
    [code]=> 000
    [message] => SUCCESS
    [account] => 995290
    [terminal] => 99529001
    [signature] => F03C3D5154FC2672C5EC05BAD3DDDF0892617CC1517517DCD37E6499AA896D73
    [card_number] => 
    [card_type] => USD
    [order_amount] => 0.01
    [order_notes] => 
    [card_number] => 
    [card_type] => null
    [card_country] => US
    [order_currency] => USD
    [order_amount] => 0.01
    [order_methods] => 
    [order_reference_id] => 250214134817000529042
    [order_remark] =>
    [merchant_reference_id] => 12345678
    [quickpay_id] => 6cdf6ebf-86c9-41ae-aee5-623ce3d48d22
    [quickpay_status] => 1
)
  1. View the result of the QuickPay ID creation.
  2. The merchant saves the returned quickpay_id (in UUID format) to initiate quick/recurring payments.

Signature​

See Signature and Verification for details on request signing and response validation.

API Reference​

👉Explore our to continue your integration.