Create a payment initiation with whitelabel

3min

Use /whitelabel endpoint in white label mode to return a token, a starting paymentURL and a initiation Id.  
POST
Request
Body Parameters
accessKey
String
required
Pre-generated by Klavi for partner
secretKey
String
required
Pre-generated by Klavi for partner
payment
Object
optional
Payment object
Curl
Node.js
JS
Python
Ruby
require "uri"
require "json"
require "net/http"

url = URI("POST https://api-testing.klavi.ai/payment/customerv1/whitelabel")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Post.new(url)
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
   "accessKey": "string",
   "secretKey": "string",
   "payment": "Object"
})

response = http.request(request)
puts response.read_body

require "uri"
require "json"
require "net/http"

url = URI("POST https://api-testing.klavi.ai/payment/customerv1/whitelabel")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Post.new(url)
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
   "accessKey": "string",
   "secretKey": "string",
   "payment": "Object"
})

response = http.request(request)
puts response.read_body
Responses
200
{
    "id": "fcb72e3a-b346-4f71-b044-971dc23232c9",
    "accessToken": "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsbLWdhdGV3YXkifQ.2dvWMBcU87IeX4J7S1_bx1uKHsXAvSDaK0RdV9xq3-OSrLA",
    "paymentURL":"https://payment-test.klavi.ai/?v=rvgvVVDDOYIR81gywJx9h1kBK55",
}
{
    "id": "fcb72e3a-b346-4f71-b044-971dc23232c9",
    "accessToken": "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsbLWdhdGV3YXkifQ.2dvWMBcU87IeX4J7S1_bx1uKHsXAvSDaK0RdV9xq3-OSrLA",
    "paymentURL":"https://payment-test.klavi.ai/?v=rvgvVVDDOYIR81gywJx9h1kBK55",
}
﻿
Request example
Shell
curl --location --request POST 'https://api-testing.klavi.ai/payment/customer/v1/whitelabel' \
--header 'Accept: application/json' \
--data-raw '{ 
    "accessKey":"youraccesskey",
    "secretKey":"yoursecretkey",
    "payment":{
        "participantId":"ef7320c1-6f96-4af5-9446-92a081b7eac9",
        "user":{
            "name":"wenyun Bruno",
            "taxId":"76109277673"
        },
        "amount":"4800"
    }
}'
curl --location --request POST 'https://api-testing.klavi.ai/payment/customer/v1/whitelabel' \
--header 'Accept: application/json' \
--data-raw '{ 
    "accessKey":"youraccesskey",
    "secretKey":"yoursecretkey",
    "payment":{
        "participantId":"ef7320c1-6f96-4af5-9446-92a081b7eac9",
        "user":{
            "name":"wenyun Bruno",
            "taxId":"76109277673"
        },
        "amount":"4800"
    }
}'
﻿
Response​﻿
Attribute
Type
Description
id
String
Payment initiation identify
accessToken
String
Token generated, one access token is only valid for one payment Initiation
paymentURL
String
Dynamic URL generated by Klavi,use this link to redirect the user to complete the payment initiation flow
﻿​﻿

Attribute	Type	Description
id	String	Payment initiation identify
accessToken	String	Token generated, one access token is only valid for one payment Initiation
paymentURL	String	Dynamic URL generated by Klavi,use this link to redirect the user to complete the payment initiation flow

Create a payment initiation

Get a payment initiation

Create a payment initiation with whitelabel

Request example

Response​﻿

Response