Skip to main content

Overview

This document provides a detailed description of the common parameters, business parameters, their formats, rules, and requirements when calling any of the payment APIs. Please read carefully before initiating a request.

note

This applies only to Klarna and other alternative payment subscription scenarios. Please read carefully before initiating a request.

Request Flow

Create QuickPay ID

Request Headers

ParameterTypeLengthRequiredDescriptionExample
accountstring6YesOceanpayment account number
terminalstring8-12YesOceanpayment terminal number
secureCodestring64YesOceanpayment secureCode

Request Parameters

ParameterTypeLengthRequiredDescriptionExample
+order
object-Yes
Order node information (JSON format)
+merchant
object-Yes
Merchant node information (JSON format)
+billing
object-Yes
Billing node information (JSON format)
+customer
object-Yes
Customer ID node information (JSON format)
+device
object-Yes
Device/environment node information (JSON format)
+subscription
object-Yes
Subscription node information (JSON format)
+customer_info
object-Yes
Customer risk control node information (compressed JSON text format)
+voucher_info
object-Yes
Goods/service node information (compressed JSON text format)

Response

ParameterTypeLengthRequiredDescriptionExample
code
object-
API result code. When not '000', the data node returns empty
message
object-
API result description, e.g., PARAM_ERROR
+data
object-
Data node information (JSON format)