3DS 実行登録
POST
https://api.forter-secure.com/merchants/{id}/3ds-execution
Path Parameters
- idstringrequired
Header Parameters
- api-versionstringrequiredExampleDescriptionDefault10.1
- x-forter-siteidstringrequiredExampleDescriptionDefault8b47c6d423ba
Body Parameters
- bodythreeDsExecutionOnboardingRequestrequiredDescription
- offeringsThreeDsOfferingsrequiredDescription
- policy_3dsbooleanrequiredDescriptionDefaulttrue
- psd2booleanrequiredDescriptionDefaulttrue
- risk_3dsbooleanrequiredDescriptionDefaulttrue
- threeDsConfigurationThreeDsConfigurationrequiredDescription
- processorsProcessor[]required
- idstringrequiredDescription
- midsMerchantIdentifierFor3ds[]requiredDescription
- acquirerIdstringrequiredDescription
- acquirerMerchantNameCardParameter[]requiredDescription
- cardSchemestring<MASTERCARD | VISA | AMEX | MAESTRO | DINERS | DISCOVER | JCB>requiredDefaultVISA
- valuestringrequiredDefaultstring
- acquirerMidstringrequiredDescriptionDefault123456789
- merchantCategoryCodestringrequiredDescriptionDefault5661
- merchantEntityCountryNumericCodestringrequiredDescriptionDefault840
- requestorIdCardParameter[]requiredDescription
- cardSchemestring<MASTERCARD | VISA | AMEX | MAESTRO | DINERS | DISCOVER | JCB>requiredDefaultVISA
- valuestringrequiredDefaultstring
- requestorNameCardParameter[]requiredDescription
- cardSchemestring<MASTERCARD | VISA | AMEX | MAESTRO | DINERS | DISCOVER | JCB>requiredDefaultVISA
- valuestringrequiredDefaultstring
- requestorUrlCardParameter[]requiredDescription
- cardSchemestring<MASTERCARD | VISA | AMEX | MAESTRO | DINERS | DISCOVER | JCB>requiredDefaultVISA
- valuestringrequiredDefaultstring
- supportedCurrenciesstring[]DescriptionDefaultUSD
- supportedSchemesstring[]DescriptionDefaultVISA
- supportedStatesstring[]Description
Responses
200
- threeDsExecutionOnboardingRequestAcceptedDescription
- requestIdstringrequiredDefaultmy-request-id-1234
- statusstringrequiredDefaultsuccess
400
401
404
500
curl
curl --request POST \
--url https://api.forter-secure.com/merchants/{id}/3ds-execution \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'api-version: 10.1' \
--header 'x-forter-siteid: 8b47c6d423ba' \
--header 'authorization: Basic <base64-encoded-api-key:>' \
--data '{
"offerings": {
"policy_3ds": true,
"psd2": true,
"risk_3ds": true
},
"threeDsConfiguration": {
"processors": [
{
"id": "",
"mids": [
{
"acquirerId": "",
"acquirerMerchantName": [
{
"cardScheme": "VISA",
"value": "string"
}
],
"acquirerMid": "123456789",
"merchantCategoryCode": "5661",
"merchantEntityCountryNumericCode": "840",
"requestorId": [
{
"cardScheme": "VISA",
"value": "string"
}
],
"requestorName": [
{
"cardScheme": "VISA",
"value": "string"
}
],
"requestorUrl": [
{
"cardScheme": "VISA",
"value": "string"
}
],
"supportedCurrencies": [
"USD"
],
"supportedSchemes": [
"VISA"
]
}
]
}
]
}
}'javascript
var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");
myHeaders.append("api-version", "10.1");
myHeaders.append("x-forter-siteid", "8b47c6d423ba");
myHeaders.append("authorization", "Basic <base64-encoded-api-key:>");
var raw = JSON.stringify({
"offerings": {
"policy_3ds": true,
"psd2": true,
"risk_3ds": true
},
"threeDsConfiguration": {
"processors": [
{
"id": "",
"mids": [
{
"acquirerId": "",
"acquirerMerchantName": [
{
"cardScheme": "VISA",
"value": "string"
}
],
"acquirerMid": "123456789",
"merchantCategoryCode": "5661",
"merchantEntityCountryNumericCode": "840",
"requestorId": [
{
"cardScheme": "VISA",
"value": "string"
}
],
"requestorName": [
{
"cardScheme": "VISA",
"value": "string"
}
],
"requestorUrl": [
{
"cardScheme": "VISA",
"value": "string"
}
],
"supportedCurrencies": [
"USD"
],
"supportedSchemes": [
"VISA"
]
}
]
}
]
}
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://api.forter-secure.com/merchants/{id}/3ds-execution", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));ruby
require "uri"
require "json"
require "net/http"
url = URI("https://api.forter-secure.com/merchants/{id}/3ds-execution")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request["api-version"] = "10.1"
request["x-forter-siteid"] = "8b47c6d423ba"
request["authorization"] = "Basic <base64-encoded-api-key:>"
request.body = JSON.dump({
"offerings": {
"policy_3ds": true,
"psd2": true,
"risk_3ds": true
},
"threeDsConfiguration": {
"processors": [
{
"id": "",
"mids": [
{
"acquirerId": "",
"acquirerMerchantName": [
{
"cardScheme": "VISA",
"value": "string"
}
],
"acquirerMid": "123456789",
"merchantCategoryCode": "5661",
"merchantEntityCountryNumericCode": "840",
"requestorId": [
{
"cardScheme": "VISA",
"value": "string"
}
],
"requestorName": [
{
"cardScheme": "VISA",
"value": "string"
}
],
"requestorUrl": [
{
"cardScheme": "VISA",
"value": "string"
}
],
"supportedCurrencies": [
"USD"
],
"supportedSchemes": [
"VISA"
]
}
]
}
]
}
})
response = https.request(request)
puts response.read_body
python
import requests
import json
url = "https://api.forter-secure.com/merchants/{id}/3ds-execution"
payload = json.dumps({
"offerings": {
"policy_3ds": True,
"psd2": True,
"risk_3ds": True
},
"threeDsConfiguration": {
"processors": [
{
"id": "",
"mids": [
{
"acquirerId": "",
"acquirerMerchantName": [
{
"cardScheme": "VISA",
"value": "string"
}
],
"acquirerMid": "123456789",
"merchantCategoryCode": "5661",
"merchantEntityCountryNumericCode": "840",
"requestorId": [
{
"cardScheme": "VISA",
"value": "string"
}
],
"requestorName": [
{
"cardScheme": "VISA",
"value": "string"
}
],
"requestorUrl": [
{
"cardScheme": "VISA",
"value": "string"
}
],
"supportedCurrencies": [
"USD"
],
"supportedSchemes": [
"VISA"
]
}
]
}
]
}
})
headers = {
'accept': 'application/json',
'content-type': 'application/json',
'api-version': '10.1',
'x-forter-siteid': '8b47c6d423ba',
'authorization': 'Basic <base64-encoded-api-key:>'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
200
// Example threeDsExecutionOnboardingRequestAccepted
{
"requestId": "",
"status": ""
}400
// Bad Request (Often missing a required parameter)
401
// Unauthorized (No valid API key provided)
404
// Not Found (The requested item doesn't exist)
500
// Server Error (Something went wrong on Forter's end)
将商家注册到Forter的3DS执行服务,以便他们的未来订单。 响应将包括一个请求ID,可用于检查状态。