Tokenization

Generate HPP Link

curl --request POST \
  --url https://api-dev.paymentoptions.com/api/v1/server-to-server-interface/hpp/generate/link \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "return_url": {
    "webhook_url": "< Webhook url >",
    "success_url": "http://www.successurl.com/",
    "decline_url": "http://www.declineurl.com/",
    "cancel_url": "http://cancelurl.com/"
  },
  "currency": "JPY",
  "merchant_id": "< Merchant ID >",
  "merchant_email": "merchant@testemail.com",
  "payment_method": {
    "type": "scheme",
    "store_payment_method": true
  },
  "billing_address": {
    "country": "JP",
    "email": "billing@testemail.com",
    "phone_number": "8112345678",
    "address1": "1-2-3 Shinjuku",
    "city": "Shinjuku-ku",
    "state": "Tokyo",
    "postal_code": "1600022"
  },
  "amount": 1000,
  "merchant_txn_ref": "2003089893366DTEST",
  "shipping_address": {
    "country": "JP",
    "email": "shipping@testemail.com",
    "phone_number": "8112345678",
    "address1": "1-2-3 Shinjuku",
    "city": "Shinjuku-ku",
    "state": "Tokyo",
    "postal_code": "1600022"
  }
}
'

import requests

url = "https://api-dev.paymentoptions.com/api/v1/server-to-server-interface/hpp/generate/link"

payload = {
    "return_url": {
        "webhook_url": "< Webhook url >",
        "success_url": "http://www.successurl.com/",
        "decline_url": "http://www.declineurl.com/",
        "cancel_url": "http://cancelurl.com/"
    },
    "currency": "JPY",
    "merchant_id": "< Merchant ID >",
    "merchant_email": "merchant@testemail.com",
    "payment_method": {
        "type": "scheme",
        "store_payment_method": True
    },
    "billing_address": {
        "country": "JP",
        "email": "billing@testemail.com",
        "phone_number": "8112345678",
        "address1": "1-2-3 Shinjuku",
        "city": "Shinjuku-ku",
        "state": "Tokyo",
        "postal_code": "1600022"
    },
    "amount": 1000,
    "merchant_txn_ref": "2003089893366DTEST",
    "shipping_address": {
        "country": "JP",
        "email": "shipping@testemail.com",
        "phone_number": "8112345678",
        "address1": "1-2-3 Shinjuku",
        "city": "Shinjuku-ku",
        "state": "Tokyo",
        "postal_code": "1600022"
    }
}
headers = {
    "Authorization": "<api-key>",
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: '<api-key>',
    'x-api-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    return_url: {
      webhook_url: '< Webhook url >',
      success_url: 'http://www.successurl.com/',
      decline_url: 'http://www.declineurl.com/',
      cancel_url: 'http://cancelurl.com/'
    },
    currency: 'JPY',
    merchant_id: '< Merchant ID >',
    merchant_email: 'merchant@testemail.com',
    payment_method: {type: 'scheme', store_payment_method: true},
    billing_address: {
      country: 'JP',
      email: 'billing@testemail.com',
      phone_number: '8112345678',
      address1: '1-2-3 Shinjuku',
      city: 'Shinjuku-ku',
      state: 'Tokyo',
      postal_code: '1600022'
    },
    amount: 1000,
    merchant_txn_ref: '2003089893366DTEST',
    shipping_address: {
      country: 'JP',
      email: 'shipping@testemail.com',
      phone_number: '8112345678',
      address1: '1-2-3 Shinjuku',
      city: 'Shinjuku-ku',
      state: 'Tokyo',
      postal_code: '1600022'
    }
  })
};

fetch('https://api-dev.paymentoptions.com/api/v1/server-to-server-interface/hpp/generate/link', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-dev.paymentoptions.com/api/v1/server-to-server-interface/hpp/generate/link",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'return_url' => [
        'webhook_url' => '< Webhook url >',
        'success_url' => 'http://www.successurl.com/',
        'decline_url' => 'http://www.declineurl.com/',
        'cancel_url' => 'http://cancelurl.com/'
    ],
    'currency' => 'JPY',
    'merchant_id' => '< Merchant ID >',
    'merchant_email' => 'merchant@testemail.com',
    'payment_method' => [
        'type' => 'scheme',
        'store_payment_method' => true
    ],
    'billing_address' => [
        'country' => 'JP',
        'email' => 'billing@testemail.com',
        'phone_number' => '8112345678',
        'address1' => '1-2-3 Shinjuku',
        'city' => 'Shinjuku-ku',
        'state' => 'Tokyo',
        'postal_code' => '1600022'
    ],
    'amount' => 1000,
    'merchant_txn_ref' => '2003089893366DTEST',
    'shipping_address' => [
        'country' => 'JP',
        'email' => 'shipping@testemail.com',
        'phone_number' => '8112345678',
        'address1' => '1-2-3 Shinjuku',
        'city' => 'Shinjuku-ku',
        'state' => 'Tokyo',
        'postal_code' => '1600022'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-dev.paymentoptions.com/api/v1/server-to-server-interface/hpp/generate/link"

	payload := strings.NewReader("{\n  \"return_url\": {\n    \"webhook_url\": \"< Webhook url >\",\n    \"success_url\": \"http://www.successurl.com/\",\n    \"decline_url\": \"http://www.declineurl.com/\",\n    \"cancel_url\": \"http://cancelurl.com/\"\n  },\n  \"currency\": \"JPY\",\n  \"merchant_id\": \"< Merchant ID >\",\n  \"merchant_email\": \"merchant@testemail.com\",\n  \"payment_method\": {\n    \"type\": \"scheme\",\n    \"store_payment_method\": true\n  },\n  \"billing_address\": {\n    \"country\": \"JP\",\n    \"email\": \"billing@testemail.com\",\n    \"phone_number\": \"8112345678\",\n    \"address1\": \"1-2-3 Shinjuku\",\n    \"city\": \"Shinjuku-ku\",\n    \"state\": \"Tokyo\",\n    \"postal_code\": \"1600022\"\n  },\n  \"amount\": 1000,\n  \"merchant_txn_ref\": \"2003089893366DTEST\",\n  \"shipping_address\": {\n    \"country\": \"JP\",\n    \"email\": \"shipping@testemail.com\",\n    \"phone_number\": \"8112345678\",\n    \"address1\": \"1-2-3 Shinjuku\",\n    \"city\": \"Shinjuku-ku\",\n    \"state\": \"Tokyo\",\n    \"postal_code\": \"1600022\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api-dev.paymentoptions.com/api/v1/server-to-server-interface/hpp/generate/link")
  .header("Authorization", "<api-key>")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"return_url\": {\n    \"webhook_url\": \"< Webhook url >\",\n    \"success_url\": \"http://www.successurl.com/\",\n    \"decline_url\": \"http://www.declineurl.com/\",\n    \"cancel_url\": \"http://cancelurl.com/\"\n  },\n  \"currency\": \"JPY\",\n  \"merchant_id\": \"< Merchant ID >\",\n  \"merchant_email\": \"merchant@testemail.com\",\n  \"payment_method\": {\n    \"type\": \"scheme\",\n    \"store_payment_method\": true\n  },\n  \"billing_address\": {\n    \"country\": \"JP\",\n    \"email\": \"billing@testemail.com\",\n    \"phone_number\": \"8112345678\",\n    \"address1\": \"1-2-3 Shinjuku\",\n    \"city\": \"Shinjuku-ku\",\n    \"state\": \"Tokyo\",\n    \"postal_code\": \"1600022\"\n  },\n  \"amount\": 1000,\n  \"merchant_txn_ref\": \"2003089893366DTEST\",\n  \"shipping_address\": {\n    \"country\": \"JP\",\n    \"email\": \"shipping@testemail.com\",\n    \"phone_number\": \"8112345678\",\n    \"address1\": \"1-2-3 Shinjuku\",\n    \"city\": \"Shinjuku-ku\",\n    \"state\": \"Tokyo\",\n    \"postal_code\": \"1600022\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-dev.paymentoptions.com/api/v1/server-to-server-interface/hpp/generate/link")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"return_url\": {\n    \"webhook_url\": \"< Webhook url >\",\n    \"success_url\": \"http://www.successurl.com/\",\n    \"decline_url\": \"http://www.declineurl.com/\",\n    \"cancel_url\": \"http://cancelurl.com/\"\n  },\n  \"currency\": \"JPY\",\n  \"merchant_id\": \"< Merchant ID >\",\n  \"merchant_email\": \"merchant@testemail.com\",\n  \"payment_method\": {\n    \"type\": \"scheme\",\n    \"store_payment_method\": true\n  },\n  \"billing_address\": {\n    \"country\": \"JP\",\n    \"email\": \"billing@testemail.com\",\n    \"phone_number\": \"8112345678\",\n    \"address1\": \"1-2-3 Shinjuku\",\n    \"city\": \"Shinjuku-ku\",\n    \"state\": \"Tokyo\",\n    \"postal_code\": \"1600022\"\n  },\n  \"amount\": 1000,\n  \"merchant_txn_ref\": \"2003089893366DTEST\",\n  \"shipping_address\": {\n    \"country\": \"JP\",\n    \"email\": \"shipping@testemail.com\",\n    \"phone_number\": \"8112345678\",\n    \"address1\": \"1-2-3 Shinjuku\",\n    \"city\": \"Shinjuku-ku\",\n    \"state\": \"Tokyo\",\n    \"postal_code\": \"1600022\"\n  }\n}"

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

{
  "id": "f49173ce-4916-445c-a831-3c1468acf14e",
  "url": "https://checkout-dev.paymentoptions.com/jp/HostedPaymentPage/hKJsdByR",
  "amount": 1000,
  "currency": "JPY",
  "merchant_txn_ref": "2003089893366DTEST",
  "merchant_id": "< Merchant ID >",
  "merchant_email": "merchant@testemail.com",
  "return_url": {
    "webhook_url": "< Webhook url >",
    "success_url": "http://www.successurl.com/",
    "decline_url": "http://www.declineurl.com/",
    "cancel_url": "http://cancelurl.com/"
  },
  "billing_address": {
    "city": "Shinjuku-ku",
    "email": "billing@testemail.com",
    "phone_number": "8112345678",
    "state": "Tokyo",
    "country": "JP",
    "address1": "1-2-3 Shinjuku",
    "postal_code": "1600022"
  },
  "shipping_address": {
    "city": "Shinjuku-ku",
    "email": "shipping@testemail.com",
    "phone_number": "8112345678",
    "state": "Tokyo",
    "country": "JP",
    "address1": "1-2-3 Shinjuku",
    "postal_code": "1600022"
  }
}

POST

api

server-to-server-interface

hpp

generate

link

Generate HPP Link

curl --request POST \
  --url https://api-dev.paymentoptions.com/api/v1/server-to-server-interface/hpp/generate/link \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "return_url": {
    "webhook_url": "< Webhook url >",
    "success_url": "http://www.successurl.com/",
    "decline_url": "http://www.declineurl.com/",
    "cancel_url": "http://cancelurl.com/"
  },
  "currency": "JPY",
  "merchant_id": "< Merchant ID >",
  "merchant_email": "merchant@testemail.com",
  "payment_method": {
    "type": "scheme",
    "store_payment_method": true
  },
  "billing_address": {
    "country": "JP",
    "email": "billing@testemail.com",
    "phone_number": "8112345678",
    "address1": "1-2-3 Shinjuku",
    "city": "Shinjuku-ku",
    "state": "Tokyo",
    "postal_code": "1600022"
  },
  "amount": 1000,
  "merchant_txn_ref": "2003089893366DTEST",
  "shipping_address": {
    "country": "JP",
    "email": "shipping@testemail.com",
    "phone_number": "8112345678",
    "address1": "1-2-3 Shinjuku",
    "city": "Shinjuku-ku",
    "state": "Tokyo",
    "postal_code": "1600022"
  }
}
'

import requests

url = "https://api-dev.paymentoptions.com/api/v1/server-to-server-interface/hpp/generate/link"

payload = {
    "return_url": {
        "webhook_url": "< Webhook url >",
        "success_url": "http://www.successurl.com/",
        "decline_url": "http://www.declineurl.com/",
        "cancel_url": "http://cancelurl.com/"
    },
    "currency": "JPY",
    "merchant_id": "< Merchant ID >",
    "merchant_email": "merchant@testemail.com",
    "payment_method": {
        "type": "scheme",
        "store_payment_method": True
    },
    "billing_address": {
        "country": "JP",
        "email": "billing@testemail.com",
        "phone_number": "8112345678",
        "address1": "1-2-3 Shinjuku",
        "city": "Shinjuku-ku",
        "state": "Tokyo",
        "postal_code": "1600022"
    },
    "amount": 1000,
    "merchant_txn_ref": "2003089893366DTEST",
    "shipping_address": {
        "country": "JP",
        "email": "shipping@testemail.com",
        "phone_number": "8112345678",
        "address1": "1-2-3 Shinjuku",
        "city": "Shinjuku-ku",
        "state": "Tokyo",
        "postal_code": "1600022"
    }
}
headers = {
    "Authorization": "<api-key>",
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: '<api-key>',
    'x-api-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    return_url: {
      webhook_url: '< Webhook url >',
      success_url: 'http://www.successurl.com/',
      decline_url: 'http://www.declineurl.com/',
      cancel_url: 'http://cancelurl.com/'
    },
    currency: 'JPY',
    merchant_id: '< Merchant ID >',
    merchant_email: 'merchant@testemail.com',
    payment_method: {type: 'scheme', store_payment_method: true},
    billing_address: {
      country: 'JP',
      email: 'billing@testemail.com',
      phone_number: '8112345678',
      address1: '1-2-3 Shinjuku',
      city: 'Shinjuku-ku',
      state: 'Tokyo',
      postal_code: '1600022'
    },
    amount: 1000,
    merchant_txn_ref: '2003089893366DTEST',
    shipping_address: {
      country: 'JP',
      email: 'shipping@testemail.com',
      phone_number: '8112345678',
      address1: '1-2-3 Shinjuku',
      city: 'Shinjuku-ku',
      state: 'Tokyo',
      postal_code: '1600022'
    }
  })
};

fetch('https://api-dev.paymentoptions.com/api/v1/server-to-server-interface/hpp/generate/link', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-dev.paymentoptions.com/api/v1/server-to-server-interface/hpp/generate/link",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'return_url' => [
        'webhook_url' => '< Webhook url >',
        'success_url' => 'http://www.successurl.com/',
        'decline_url' => 'http://www.declineurl.com/',
        'cancel_url' => 'http://cancelurl.com/'
    ],
    'currency' => 'JPY',
    'merchant_id' => '< Merchant ID >',
    'merchant_email' => 'merchant@testemail.com',
    'payment_method' => [
        'type' => 'scheme',
        'store_payment_method' => true
    ],
    'billing_address' => [
        'country' => 'JP',
        'email' => 'billing@testemail.com',
        'phone_number' => '8112345678',
        'address1' => '1-2-3 Shinjuku',
        'city' => 'Shinjuku-ku',
        'state' => 'Tokyo',
        'postal_code' => '1600022'
    ],
    'amount' => 1000,
    'merchant_txn_ref' => '2003089893366DTEST',
    'shipping_address' => [
        'country' => 'JP',
        'email' => 'shipping@testemail.com',
        'phone_number' => '8112345678',
        'address1' => '1-2-3 Shinjuku',
        'city' => 'Shinjuku-ku',
        'state' => 'Tokyo',
        'postal_code' => '1600022'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-dev.paymentoptions.com/api/v1/server-to-server-interface/hpp/generate/link"

	payload := strings.NewReader("{\n  \"return_url\": {\n    \"webhook_url\": \"< Webhook url >\",\n    \"success_url\": \"http://www.successurl.com/\",\n    \"decline_url\": \"http://www.declineurl.com/\",\n    \"cancel_url\": \"http://cancelurl.com/\"\n  },\n  \"currency\": \"JPY\",\n  \"merchant_id\": \"< Merchant ID >\",\n  \"merchant_email\": \"merchant@testemail.com\",\n  \"payment_method\": {\n    \"type\": \"scheme\",\n    \"store_payment_method\": true\n  },\n  \"billing_address\": {\n    \"country\": \"JP\",\n    \"email\": \"billing@testemail.com\",\n    \"phone_number\": \"8112345678\",\n    \"address1\": \"1-2-3 Shinjuku\",\n    \"city\": \"Shinjuku-ku\",\n    \"state\": \"Tokyo\",\n    \"postal_code\": \"1600022\"\n  },\n  \"amount\": 1000,\n  \"merchant_txn_ref\": \"2003089893366DTEST\",\n  \"shipping_address\": {\n    \"country\": \"JP\",\n    \"email\": \"shipping@testemail.com\",\n    \"phone_number\": \"8112345678\",\n    \"address1\": \"1-2-3 Shinjuku\",\n    \"city\": \"Shinjuku-ku\",\n    \"state\": \"Tokyo\",\n    \"postal_code\": \"1600022\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api-dev.paymentoptions.com/api/v1/server-to-server-interface/hpp/generate/link")
  .header("Authorization", "<api-key>")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"return_url\": {\n    \"webhook_url\": \"< Webhook url >\",\n    \"success_url\": \"http://www.successurl.com/\",\n    \"decline_url\": \"http://www.declineurl.com/\",\n    \"cancel_url\": \"http://cancelurl.com/\"\n  },\n  \"currency\": \"JPY\",\n  \"merchant_id\": \"< Merchant ID >\",\n  \"merchant_email\": \"merchant@testemail.com\",\n  \"payment_method\": {\n    \"type\": \"scheme\",\n    \"store_payment_method\": true\n  },\n  \"billing_address\": {\n    \"country\": \"JP\",\n    \"email\": \"billing@testemail.com\",\n    \"phone_number\": \"8112345678\",\n    \"address1\": \"1-2-3 Shinjuku\",\n    \"city\": \"Shinjuku-ku\",\n    \"state\": \"Tokyo\",\n    \"postal_code\": \"1600022\"\n  },\n  \"amount\": 1000,\n  \"merchant_txn_ref\": \"2003089893366DTEST\",\n  \"shipping_address\": {\n    \"country\": \"JP\",\n    \"email\": \"shipping@testemail.com\",\n    \"phone_number\": \"8112345678\",\n    \"address1\": \"1-2-3 Shinjuku\",\n    \"city\": \"Shinjuku-ku\",\n    \"state\": \"Tokyo\",\n    \"postal_code\": \"1600022\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-dev.paymentoptions.com/api/v1/server-to-server-interface/hpp/generate/link")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"return_url\": {\n    \"webhook_url\": \"< Webhook url >\",\n    \"success_url\": \"http://www.successurl.com/\",\n    \"decline_url\": \"http://www.declineurl.com/\",\n    \"cancel_url\": \"http://cancelurl.com/\"\n  },\n  \"currency\": \"JPY\",\n  \"merchant_id\": \"< Merchant ID >\",\n  \"merchant_email\": \"merchant@testemail.com\",\n  \"payment_method\": {\n    \"type\": \"scheme\",\n    \"store_payment_method\": true\n  },\n  \"billing_address\": {\n    \"country\": \"JP\",\n    \"email\": \"billing@testemail.com\",\n    \"phone_number\": \"8112345678\",\n    \"address1\": \"1-2-3 Shinjuku\",\n    \"city\": \"Shinjuku-ku\",\n    \"state\": \"Tokyo\",\n    \"postal_code\": \"1600022\"\n  },\n  \"amount\": 1000,\n  \"merchant_txn_ref\": \"2003089893366DTEST\",\n  \"shipping_address\": {\n    \"country\": \"JP\",\n    \"email\": \"shipping@testemail.com\",\n    \"phone_number\": \"8112345678\",\n    \"address1\": \"1-2-3 Shinjuku\",\n    \"city\": \"Shinjuku-ku\",\n    \"state\": \"Tokyo\",\n    \"postal_code\": \"1600022\"\n  }\n}"

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

{
  "id": "f49173ce-4916-445c-a831-3c1468acf14e",
  "url": "https://checkout-dev.paymentoptions.com/jp/HostedPaymentPage/hKJsdByR",
  "amount": 1000,
  "currency": "JPY",
  "merchant_txn_ref": "2003089893366DTEST",
  "merchant_id": "< Merchant ID >",
  "merchant_email": "merchant@testemail.com",
  "return_url": {
    "webhook_url": "< Webhook url >",
    "success_url": "http://www.successurl.com/",
    "decline_url": "http://www.declineurl.com/",
    "cancel_url": "http://cancelurl.com/"
  },
  "billing_address": {
    "city": "Shinjuku-ku",
    "email": "billing@testemail.com",
    "phone_number": "8112345678",
    "state": "Tokyo",
    "country": "JP",
    "address1": "1-2-3 Shinjuku",
    "postal_code": "1600022"
  },
  "shipping_address": {
    "city": "Shinjuku-ku",
    "email": "shipping@testemail.com",
    "phone_number": "8112345678",
    "state": "Tokyo",
    "country": "JP",
    "address1": "1-2-3 Shinjuku",
    "postal_code": "1600022"
  }
}

Key Points

If the payload is pre-filled with data (e.g., amount, currency, customer details, return_url, payment method), these details will be reflected on the HPP, providing a streamlined user experience.
If the payload lacks certain data, the customer will need to manually enter the missing information on the HPP.
Ensure that the necessary headers and authentication details are included to successfully generate the HPP link.

Flow diagram

Notes

store_payment_method: Must be set to true in the payload to store the card token for future use.

Request Example

{
  "payment_method": {
    "type": "scheme",
    "store_payment_method": true
  }

Setting store_payment_method to true ensures that the card token is stored for future transactions without needing to re-enter card details.

Response Example

{
  "transaction_details": {
    "id": "<transaction_id>",
    "ref": <ref>,
    "timestamp": "yyyy-mm-ddThh:mm:ss.000Z",
    "merchant_txn_ref": "<string>",
    "stored_payment_method_id": "094db781-fabc-4c6d-8fcd-18bee06a527a"
  }
}

The stored_payment_method_id can be used in the Use of Card Token API for future transactions without needing to re-enter card details.

Api Parameters

Authorizations

Authorization

string

header

required

API Key for Authorization. Format: 'Basic YOUR_API_KEY_HERE'

x-api-key

string

header

required

API Key specific to x-api-key.

Body

application/json

The request payload to generate an HPP link.

return_url

object

required

A JSON object containing the Return URLs.

Show child attributes

currency

string

required

The processing currency (e.g., JPY).

Maximum string length: 3

Example:

"JPY"

merchant_id

string

required

The merchant ID (DASMID).

Maximum string length: 128

Example:

"< Merchant ID >"

merchant_email

string

required

The email address of the Merchant.

Maximum string length: 45

Example:

"merchant@testemail.com"

payment_method

object

required

A JSON object containing Payment Method.

Show child attributes

billing_address

object

required

A JSON object containing the billing address of the cardholder.

Show child attributes

amount

number

The amount of the transaction.

Example:

1000

merchant_txn_ref

string

The merchant transaction reference ID.

Maximum string length: 45

Example:

"2003089893366DTEST"

shipping_address

object

A JSON object containing the shipping address of the cardholder.

Show child attributes

Response

200 - application/json

HPP link generated successfully

string

The transaction reference ID.

Example:

"f49173ce-4916-445c-a831-3c1468acf14e"

url

string

The URL Link of the hosted payment page link generated.

Example:

"https://checkout-dev.paymentoptions.com/jp/HostedPaymentPage/hKJsdByR"

amount

number

The amount of the transaction.

Example:

1000

currency

string

The processing currency of the transaction.

Example:

"JPY"

merchant_txn_ref

string

The merchant transaction reference ID.

Example:

"2003089893366DTEST"

merchant_id

string

The DAS merchant ID of the transaction performed.

Example:

"< Merchant ID >"

merchant_email

string

The email address of the Merchant.

Example:

"merchant@testemail.com"

return_url

object

A JSON object containing the Return URL.

Show child attributes

billing_address

object

A JSON object containing the billing address of the cardholder.

Show child attributes

shipping_address

object

A JSON object containing the shipping address of the cardholder.

Show child attributes

Hosted Payment Page HTTP Response

⌘I

Getting Started

API Endpoints

Error and Response

Webhook

Key Points

Flow diagram

Notes

Api Parameters

Authorizations

Body

Response

​Key Points

​Flow diagram

​Notes

​Api Parameters

Authorizations

Body

Response

Key Points

Flow diagram

Notes

Api Parameters