HPPリンクを生成
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"
}
}ホスト決済ページ
トークン化
取引をキャプチャするためのホスト型決済ページ（HPP）を開くリンクを生成します。
POST
/
api
/
v1
/
server-to-server-interface
/
hpp
/
generate
/
link
HPPリンクを生成
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"
}
}重要なポイント
- ペイロードにデータ（例：金額、通貨、顧客詳細、return_url、決済方法）が事前入力されている場合、これらの詳細はHPPに反映され、スムーズなユーザー体験を提供します。
- ペイロードに必要なデータが欠けている場合、顧客はHPPで不足している情報を手動で入力する必要があります。
- 必要なヘッダーと認証詳細が含まれていることを確認し、HPPリンクを正常に生成します。
フローダイアグラム
ノート
store_payment_method: 将来の使用のためにカードトークンを保存するには、ペイロードでtrueに設定する必要があります。
リクエスト例
{
"payment_method": {
"type": "scheme",
"store_payment_method": true
}
store_payment_method を true に設定すると、カードトークンが保存され、今後の取引でカード詳細を再入力する必要がなくなります。
レスポンス例
{
"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"
}
}
stored_payment_method_id は、カード詳細を再入力することなく、今後の取引でカードトークンAPIを使用するために利用できます。
APIパラメータ
承認
認証のためのAPIキー。フォーマット: 'Basic YOUR_API_KEY_HERE'
x-api-key専用のAPIキー。
ボディ
application/json
HPPリンクを生成するためのリクエストペイロード。
リターンURLを含むJSONオブジェクト。
Show child attributes
Show child attributes
処理通貨（例：JPY）。
Maximum string length:
3例:
"JPY"
加盟店ID（DASMID）。
Maximum string length:
128例:
"< Merchant ID >"
加盟店のメールアドレス。
Maximum string length:
45例:
"merchant@testemail.com"
支払い方法を含むJSONオブジェクト。
Show child attributes
Show child attributes
カード所有者の請求先住所を含むJSONオブジェクト。
Show child attributes
Show child attributes
取引の金額。
例:
1000
加盟店の取引参照ID。
Maximum string length:
45例:
"2003089893366DTEST"
カード所有者の配送先住所を含むJSONオブジェクト。
Show child attributes
Show child attributes
レスポンス
200 - application/json
HPPリンクが正常に生成されました
取引参照ID。
例:
"f49173ce-4916-445c-a831-3c1468acf14e"
生成されたホスト型決済ページ（HPP）リンクのURL。
例:
"https://checkout-dev.paymentoptions.com/jp/HostedPaymentPage/hKJsdByR"
取引の金額。
例:
1000
取引の処理通貨。
例:
"JPY"
加盟店の取引参照ID。
例:
"2003089893366DTEST"
実行された取引のDAS加盟店ID。
例:
"< Merchant ID >"
加盟店のメールアドレス。
例:
"merchant@testemail.com"
リターンURLを含むJSONオブジェクト。
Show child attributes
Show child attributes
カード所有者の請求先住所を含むJSONオブジェクト。
Show child attributes
Show child attributes
カード所有者の配送先住所を含むJSONオブジェクト。
Show child attributes
Show child attributes
⌘I