LogoLogo
PayShield - Transaction Processing / TxProcess
PayShield - Transaction Processing / TxProcess
  • Overview
  • Transaction Details
    • Transaction Types
    • Payment Methods
    • Transaction Lifecyle / Workflow
  • Integrations & API's
    • Single Transaction API (TxHandler)
    • REST API
      • Site - SID - Payments
      • Transaction - ptxid
      • Merchant Management
      • Fraud Check
      • Payment Refund
    • Field Definitions
    • Responses
    • Testing Data
  • Emulators
    • NMI - API
Powered by GitBook
On this page
  1. Integrations & API's
  2. REST API

Merchant Management

API's to create and manage merchants

PreviousTransaction - ptxidNextFraud Check

Last updated 4 months ago

Introduction

Merchants (mid) in TxShield are treated as the parent node of a Tree. The layer underneath the Merchant is the Retailer (rid) and the lowest node is a Site (sid).

Merchant --> Retailer --> Site

A Site is the object that actions / transactions are done on, in the system. If I wanted to process cred card transaction, i would create a payment Site, and use the credentials for that site to If I wanted to 3ds Authentications, I would create a 3ds Site and use those credentials to do 3ds Authentications with the

To create a Merchant, you will need to call the merchant create endpoint. This will return a Merchant id (mid). You can then use this mid to create a Retailer by call the retailer create endpoint. This will return a Retailer Id (rid). Using the rid you can then create a Site by calling the site create endpoint. This will return a Site Id (sid).

Authentication

Every call on this page requires a Bearer token to be sent in the Authorization header. You can obtain a Bearer token from the System Administrator.

Merchant, Retailer, Site.

Merchant Create

Example JSON data.

{
  "name": "New Merchant",
  "payments": true,
  "threeDS": true,
  "alerts": true,
  "cbm": true,
  "order_insights": true,
  "oi_merchant_id": "",
  "remarks": "My New Merchant",
  "themeid": 0
}

Merchant Details

Returns the details of a Merchant, doesn't have any body parameters.

Retailer Create

{
  "name": "New Retailer",
  "currency": "USD",
  "margin_percentage": 0,
  "contact_email": "myemail@contact.com",
  "remarks": "Created At xx",
  "description": "For my USD Sites"
}

Retailer Details

Returns the details of a Retailer

Site Create

{
  "name": "string",
  "reseller_id": 0,
  "url": "string",
  "remarks": "string",
  "description": "string",
  "currency": "string",
  "support_group": 0,
  "cat_id": 0
}

Site Details

Returns the details of a site. Doesn't have any body params.

Site List

Returns a list of sites. Doesn't have any body params.

Site Payment

{
  "stop_send_email": 0,
  "cbreportemail": "string",
  "ftid": 0,
  "skip_ccv": 0,
  "bin_currency": 0,
  "allow_rebilling": 0,
  "proceedeveniffail": 0,
  "margin_percentage": "string",
  "first_transaction_alert": 0,
  "notify_email": "string",
  "allow_refund": 0,
  "allow_refund_time": 0,
  "emaildomain": "string",
  "shipping_n_tracking": 0
}

Site 3ds

Mark a site as a 3ds site. Once set to 3ds, the site can never be changed to Payment or Alert. Example JSON data

{
  "settings": {
    "clientMode": "string",
    "enableResult": "string",
    "disableChallenge": "string",
    "enable3ds1Frictionless": "string",
    "enable3DS1Only": "string",
    "requestorName": "string",
    "requestorURL": "string",
    "authenticationInd": "string",
    "challengeInd": "string",
    "acctType": "string",
    "acquirerMerchantPwd": "string",
    "mcc": "string",
    "merchantCountryCode": "string",
    "merchantName": "string",
    "messageCategory": "string",
    "purchaseCurrency": "string",
    "transType": "string",
    "verbose": 0,
    "acquirerBin": "string",
    "acquirerMid": "string",
    "masterAcquirerBin": "string",
    "masterAcquirerMid": "string",
    "JCBAcquirerBin": "string",
    "JCBAcquirerMid": "string",
    "CUPAcquirerBin": "string",
    "CUPAcquirerMid": "string",
    "AMEXAcquirerBin": "string",
    "AMEXAcquirerMid": "string"
  },
  "shieldsettings": {
    "skip3d2": 0,
    "three_ds_provider": "string",
    "threedsprotocolversion": "string",
    "paayauth3d2": "string",
    "gpay_merchant_token": "string",
    "gpay_merchant_id": "string",
    "gpay_base_url": "string",
    "hitrust_account_id": "string",
    "hitrust_password": "string",
    "hitrust_base_url": "string",
    "hitrust_mastercard_prefix": "string"
  }
}

Site Alert

Set a site as an Alert site. Once set to Alert it can never be changed to Payment or 3ds. Example JSON data

{
  "alertapiurl": "string",
  "descriptorid": "string",
  "username": "string",
  "token": "string",
  "default_dispute_action": "string",
  "max_refund_amount": 0,
  "alert_triggeremail": 0,
  "alert_email": "string",
  "shieldrdr_review_email": "string",
  "statusupdate_url": "string"
}

Supporting Data

County List

List of countries and their country codes.

Currency List

A list of supported currency and their currency codes.

Fraud Template List

A list of currently setup Fraud Templates.

Reseller List

A list of available resellers.

Support Group List

A list of support groups.

Theme List

A list of available themes.

Site Category List

A list of available site categories.

Payment Method List

A list of supported Payment Methods.

Create a new merchant in the system. This call will return a MID that can be used to create Retailers. list of available themes can be retrieved from the

Creates a new Retailer, you will need the mid of the Merchant that you want to attach the retailer too. A list of available currencies can be found at the Example JSON data

Create a new Site, You will need the mid and rid of the merchant/retailer you want this site attached too. A list of available resellers can be found at the A list of available support groups can be found at the A list of available categories can be found at the Example JSON data:

Marks a site as a Payment site. Once set to payment, the site can never be changed to 3ds or Alert. A list of available fraud templates can be retrieved from the Example JSON data.

themes endpoint.
currency endpoint.
reseller endpoint.
support group endpoint.
categories endpoint.
fraud template endpoint.
process payments.
3ds SDK.
post
Authorizations
Path parameters
sidintegerRequired

Retailer Site Id for get site details

Responses
200
Successfully returned site details
application/json
401
Unauthorized
application/json
500
Error
application/json
post
POST /api/v3/site/{sid}/details HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Accept: */*
{
  "name": "text",
  "category": "text",
  "emaildomain": "text",
  "payments": {
    "details": {
      "sid": 1,
      "rid": 1,
      "mid": 1,
      "mtid": 1,
      "name": "text",
      "description": "text",
      "remarks": "text",
      "url": "text",
      "tx_notification_email": 1,
      "support_group": 1,
      "support_site": "text",
      "support_email": "text",
      "support_phone": "text",
      "cat_id": 1,
      "status": "text",
      "reseller_id": 1,
      "skip_ccv": 1,
      "currency": "text",
      "creation_date": "text",
      "notify_email": "text",
      "allow_rebilling": 1,
      "allow_refund": 1,
      "allow_refund_time": 1,
      "ftid": 1,
      "first_transaction_alert": 1,
      "cbreportemail": "text",
      "margin_percentage": 1,
      "stop_send_email": 1,
      "tradable": 1,
      "fx_provider_link": "text",
      "fx_provider_auth": "text",
      "smtpsetting": "text",
      "customer_comm": 1,
      "autorefundonCB": 1,
      "auth_expiry_days": "text",
      "bin_currency": 1,
      "shipperid": "text",
      "skip3d2": 1,
      "emaildomain": "text",
      "proceedeveniffail": 1,
      "cart_margin_percentage": 1,
      "shipping_n_tracking": 1
    },
    "balance": 1,
    "accessRecords": [
      {
        "plid": 1,
        "gxsid": 1,
        "tx_actions": "text",
        "mxsid": 1,
        "name": "text",
        "descriptor": "text",
        "currency_code": "text",
        "pay_method": "text",
        "default_gateway": 1,
        "test_mode": 1,
        "max_limit_tx": "text",
        "max_limit_30days": "text",
        "secureplid": 1,
        "reseller_group_id": 1,
        "rates_base_id": 1,
        "paiid": 1
      }
    ]
  },
  "threeDS": {
    "details": {
      "sid": 1,
      "rid": 1,
      "mid": 1,
      "mtid": 1,
      "name": "text",
      "description": "text",
      "remarks": "text",
      "url": "text",
      "tx_notification_email": 1,
      "support_group": 1,
      "support_site": "text",
      "support_email": "text",
      "support_phone": "text",
      "cat_id": 1,
      "status": "text",
      "reseller_id": 1,
      "skip_ccv": 1,
      "currency": "text",
      "creation_date": "text",
      "notify_email": "text",
      "allow_rebilling": 1,
      "allow_refund": 1,
      "allow_refund_time": 1,
      "ftid": 1,
      "first_transaction_alert": 1,
      "cbreportemail": "text",
      "margin_percentage": 1,
      "stop_send_email": 1,
      "tradable": 1,
      "fx_provider_link": "text",
      "fx_provider_auth": "text",
      "smtpsetting": "text",
      "customer_comm": 1,
      "autorefundonCB": 1,
      "auth_expiry_days": "text",
      "bin_currency": 1,
      "shipperid": "text",
      "skip3d2": 1,
      "emaildomain": "text",
      "proceedeveniffail": 1,
      "cart_margin_percentage": 1,
      "shipping_n_tracking": 1
    },
    "settings": {
      "sid": 1,
      "clientMode": "text",
      "enableResult": "text",
      "disableChallenge": "text",
      "enable3ds1Frictionless": "text",
      "enable3DS1Only": "text",
      "requestorName": "text",
      "requestorURL": "text",
      "authenticationInd": "text",
      "challengeInd": "text",
      "acctType": "text",
      "acquirerBin": "text",
      "acquirerMid": "text",
      "acquirerMerchantPwd": "text",
      "mcc": "text",
      "merchantCountryCode": "text",
      "merchantName": "text",
      "messageCategory": "text",
      "purchaseCurrency": "text",
      "transType": "text",
      "verbose": 1,
      "masterAcquirerBin": "text",
      "masterAcquirerMid": "text",
      "JCBAcquirerBin": "text",
      "JCBAcquirerMid": "text",
      "CUPAcquirerBin": "text",
      "CUPAcquirerMid": "text",
      "AMEXAcquirerBin": "text",
      "AMEXAcquirerMid": "text"
    },
    "shieldSettings": {
      "skip3d2": 1,
      "three_ds_provider": "text",
      "threedsprotocolversion": "text",
      "paayauth3d2": "text",
      "gpay_merchant_token": "text",
      "gpay_merchant_id": "text",
      "gpay_base_url": "text",
      "hitrust_account_id": "text",
      "hitrust_password": "text",
      "hitrust_base_url": "text",
      "hitrust_mastercard_prefix": "text"
    }
  },
  "alert": {
    "details": {
      "sid": 1,
      "rid": 1,
      "mid": 1,
      "mtid": 1,
      "name": "text",
      "description": "text",
      "remarks": "text",
      "url": "text",
      "tx_notification_email": 1,
      "support_group": 1,
      "support_site": "text",
      "support_email": "text",
      "support_phone": "text",
      "cat_id": 1,
      "status": "text",
      "reseller_id": 1,
      "skip_ccv": 1,
      "currency": "text",
      "creation_date": "text",
      "notify_email": "text",
      "allow_rebilling": 1,
      "allow_refund": 1,
      "allow_refund_time": 1,
      "ftid": 1,
      "first_transaction_alert": 1,
      "cbreportemail": "text",
      "margin_percentage": 1,
      "stop_send_email": 1,
      "tradable": 1,
      "fx_provider_link": "text",
      "fx_provider_auth": "text",
      "smtpsetting": "text",
      "customer_comm": 1,
      "autorefundonCB": 1,
      "auth_expiry_days": "text",
      "bin_currency": 1,
      "shipperid": "text",
      "skip3d2": 1,
      "emaildomain": "text",
      "proceedeveniffail": 1,
      "cart_margin_percentage": 1,
      "shipping_n_tracking": 1
    },
    "settings": {
      "alertapiurl": "text",
      "descriptorid": "text",
      "username": "text",
      "password": "text",
      "default_dispute_action": "text",
      "max_refund_amount": 1,
      "alert_triggeremail": 1,
      "alert_email": "text",
      "shieldrdr_review_email": "text",
      "statusupdate_url": "text"
    },
    "accessRecords": [
      {
        "plid": 1,
        "gxsid": 1,
        "tx_actions": "text",
        "mxsid": 1,
        "name": "text",
        "descriptor": "text",
        "currency_code": "text",
        "pay_method": "text",
        "default_gateway": 1,
        "test_mode": 1,
        "max_limit_tx": "text",
        "max_limit_30days": "text",
        "secureplid": 1,
        "reseller_group_id": 1,
        "rates_base_id": 1,
        "paiid": 1
      }
    ]
  }
}
post
Authorizations
Responses
200
Successfully returned site list
application/json
401
Unauthorized
application/json
500
Error
application/json
post
POST /api/v3/site/list HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Accept: */*
{
  "list": [
    {
      "sid": 1,
      "name": "text"
    }
  ]
}
post
Authorizations
Responses
200
Successfully returned country list
application/json
401
Unauthorized
application/json
500
Error
application/json
post
POST /api/v3/datasource/country HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Accept: */*
[
  {
    "abrv_two": "text",
    "name": "text",
    "name_soundex": "text",
    "abrv_numeric": "text",
    "abrv_currency": "text",
    "symbol": "text",
    "abrv_three": "text"
  }
]
post
Authorizations
Responses
200
Successfully returned default currency list
application/json
401
Unauthorized
application/json
500
Error
application/json
post
POST /api/v3/datasource/defaultcurrency HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Accept: */*
{
  "AUD": "Australian Dollar",
  "BTC": "Bitcoin",
  "BRL": "Brazil real",
  "GBP": "British Pound",
  "BGN": "Bulgarian lev",
  "CAD": "Canadian Dollar",
  "COP": "Columbian Peso",
  "CZK": "Czech koruna",
  "DKK": "Danish krone",
  "EEK": "Estonian kroon",
  "EUR": "Euro",
  "GHS": "Ghana Cedi",
  "GLD": "Gold",
  "HKD": "Hong Kong Dollar",
  "HUF": "Hungarian forint",
  "ISK": "Iceland krona",
  "INR": "Indian Rupee",
  "IDR": "Indonesian Rupee",
  "JPY": "Japanese Yen",
  "LVL": "Latvian lats",
  "LTL": "Lithuanian Litas",
  "MYR": "Malaysian ringgit",
  "MXN": "Mexican peso",
  "NZD": "New Zealand Dollar",
  "NGN": "Nigerian Naira",
  "NOK": "Norwegian krone",
  "PEN": "Nuevo Sol (Peru)",
  "OMR": "Omani rial",
  "ARS": "Peso (Argentina)",
  "CLP": "Peso (Chile)",
  "UYU": "Peso (Uruguay)",
  "PHP": "Philippine peso",
  "PLN": "Polish zloty",
  "RON": "Romanian lei",
  "RUB": "Russian Ruble",
  "SGD": "Singapore Dollar",
  "ZAR": "South African rand",
  "KRW": "South Korean Won",
  "SEK": "Swedish krona",
  "CHF": "Swiss franc",
  "TWD": "Taiwan Dollar",
  "THB": "Thai Baht",
  "TRY": "Turkish Lira",
  "USD": "US Dollar",
  "VND": "Vietnam Dong",
  "WST": "Western Samoan Tala",
  "CNY": "Yuan Renminbi"
}
post
Authorizations
Responses
200
Successfully returned fraud template list
application/json
401
Unauthorized
application/json
500
Error
application/json
post
POST /api/v3/datasource/fraudtemplate HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Accept: */*
[
  {
    "ftid": 1,
    "name": "text"
  }
]
post
Authorizations
Responses
200
Successfully returned support group list
application/json
401
Unauthorized
application/json
500
Error
application/json
post
POST /api/v3/datasource/supportgroup HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Accept: */*
[
  {
    "sgid": "text",
    "name": "text",
    "email": "text"
  }
]
post
Authorizations
Responses
200
Successfully returned theme list
application/json
401
Unauthorized
application/json
500
Error
application/json
post
POST /api/v3/datasource/theme HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Accept: */*
[
  {
    "themeid": "text",
    "theme_name": "text",
    "dashboard_url": "text",
    "from_email_address": "text",
    "from_name": "text"
  }
]
post
Authorizations
Responses
200
Successfully returned site category list
application/json
401
Unauthorized
application/json
500
Error
application/json
post
POST /api/v3/datasource/sitecategory HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Accept: */*
[
  {
    "cat_id": "text",
    "category": "text",
    "parent": 1
  }
]
post
Authorizations
Responses
200
Successfully returned site category list
application/json
401
Unauthorized
application/json
500
Error
application/json
post
POST /api/v3/datasource/paymentmethods HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Accept: */*
[
  {
    "pmid": "text",
    "pay_method": "text",
    "type": "text",
    "regex": "text",
    "display": "text",
    "pending_reminders": "text"
  }
]
post
Authorizations
Path parameters
midintegerRequired

Merchant Id that related to retailer and retailer site

Body
namestringOptional
currencystringOptional
margin_percentageintegerOptional
contact_emailstringOptional
remarksstringOptional
descriptionstringOptional
Responses
200
Successfully create retailer
application/json
400
Invalid condition
application/json
401
Unauthorized
application/json
404
Not found
application/json
500
Error
application/json
post
POST /api/v3/retailer/mid/{mid}/create HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 116

{
  "name": "text",
  "currency": "text",
  "margin_percentage": 1,
  "contact_email": "text",
  "remarks": "text",
  "description": "text"
}
{
  "status": "text",
  "msg": "text",
  "rid": 1
}
post
Authorizations
Body
ridintegerOptional

Retailer id from txshield core

Responses
200
Successfully returned reseller list
application/json
401
Unauthorized
application/json
500
Error
application/json
post
POST /api/v3/datasource/reseller HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 9

"rid=1"
[
  {
    "reseller_id": 1,
    "name": "text",
    "currency": "text"
  }
]
  • Introduction
  • Authentication
  • Merchant, Retailer, Site.
  • Merchant Create
  • POST/merchant/create
  • Merchant Details
  • POST/merchant/{mid}/details
  • Retailer Create
  • POST/retailer/mid/{mid}/create
  • Retailer Details
  • POST/retailer/{rid}/details
  • Site Create
  • POST/site/mid/{mid}/rid/{rid}/create
  • Site Details
  • POST/site/{sid}/details
  • Site List
  • POST/site/list
  • Site Payment
  • POST/site/mid/{mid}/rid/{rid}/sid/{sid}/payment
  • Site 3ds
  • POST/site/mid/{mid}/rid/{rid}/sid/{sid}/3ds
  • Site Alert
  • POST/site/mid/{mid}/rid/{rid}/sid/{sid}/alert
  • Supporting Data
  • County List
  • POST/datasource/country
  • Currency List
  • POST/datasource/defaultcurrency
  • Fraud Template List
  • POST/datasource/fraudtemplate
  • Reseller List
  • POST/datasource/reseller
  • Support Group List
  • POST/datasource/supportgroup
  • Theme List
  • POST/datasource/theme
  • Site Category List
  • POST/datasource/sitecategory
  • Payment Method List
  • POST/datasource/paymentmethods
post
Authorizations
Path parameters
midintegerRequired

Merchant Id for get merchant details

Responses
200
Successfully returned merchant details
application/json
401
Unauthorized
application/json
500
Error
application/json
post
post
Authorizations
Path parameters
ridintegerRequired

Retailer Id for get retailer details

Responses
200
Successfully returned retailer details
application/json
401
Unauthorized
application/json
500
Error
application/json
post
post
Authorizations
Body
namestringOptional
paymentsbooleanOptional
threeDSbooleanOptional
alertsbooleanOptional
cbmbooleanOptional
order_insightsbooleanOptional
oi_merchant_idstringOptional
remarksstringOptional
themeidintegerOptional
Responses
200
Successfully create merchant
application/json
400
Invalid condition
application/json
401
Unauthorized
application/json
404
Not found
application/json
500
Error
application/json
post
POST /api/v3/merchant/create HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 146

{
  "name": "text",
  "payments": true,
  "threeDS": true,
  "alerts": true,
  "cbm": true,
  "order_insights": true,
  "oi_merchant_id": "text",
  "remarks": "text",
  "themeid": 1
}
{
  "status": "text",
  "msg": "text",
  "mid": 1
}
POST /api/v3/merchant/{mid}/details HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Accept: */*
{
  "name": "text",
  "oi_merchant_id": "text",
  "remarks": "text",
  "themeid": 1,
  "status": "text"
}
POST /api/v3/retailer/{rid}/details HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Accept: */*
{
  "name": "text",
  "rcode": "text",
  "remarks": "text",
  "description": "text",
  "margin_percentage": "text",
  "contact_email": "text",
  "currency": "text",
  "status": "text"
}
post
Authorizations
Path parameters
midintegerRequired

Merchant Id that related to retailer and retailer site

ridintegerRequired

Retailer Id that related to retailer site

Body
namestringOptional
reseller_idintegerOptional
urlstringOptional
remarksstringOptional
descriptionstringOptional
currencystringOptional
support_groupintegerOptional

support_group(id) is required field and not allowed for 0, for more information about support_group please see the endpoint /api/v3/datasource/supportgroup

cat_idintegerOptional

cat_id is required field and not allowed for 0, for more information about cat_id please see the endpoint /api/v3/datasource/sitecategory

Responses
200
Successfully create site
application/json
400
Invalid condition
application/json
401
Unauthorized
application/json
404
Not found
application/json
500
Error
application/json
post
POST /api/v3/site/mid/{mid}/rid/{rid}/create HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 129

{
  "name": "text",
  "reseller_id": 1,
  "url": "text",
  "remarks": "text",
  "description": "text",
  "currency": "text",
  "support_group": 1,
  "cat_id": 1
}
{
  "status": "text",
  "msg": "text",
  "sid": 1,
  "rcode": "text"
}
post
Authorizations
Path parameters
midintegerRequired

Merchant Id that related to retailer and retailer site

ridintegerRequired

Retailer Id that related to retailer site

sidintegerRequired

Retailer Site Id that related retailer site proceed to setup payment info

Body
stop_send_emailintegerOptional

allowed for 0 or 1 only

ftidintegerOptional

for more information about Fraud Template (ftid) please see the endpoint /api/v3/datasource/fraudtemplate

skip_ccvintegerOptional

allowed for 0 or 1 only

bin_currencyintegerOptional

allowed for 0 or 1 only

allow_rebillingintegerOptional

allowed for 0 or 1 only

proceedeveniffailintegerOptional

allowed for 0 or 1 only

margin_percentagestringOptional
first_transaction_alertintegerOptional

allowed for 0 or 1 only

notify_emailstringOptional
allow_refundintegerOptional

one of the value from [0,10,25,50,100,200,500,-1] per day; 0 = Never, -1 = Unlimited

allow_refund_timeintegerOptional

one of the value from [0,1,2,3,4,5,6,7,8,9,10,15,20] Day(s); 0 = Not Active

emaildomainstringOptional
shipping_n_trackingintegerOptional

allowed for 0 or 1 only

Responses
200
Successfully setup payment site
application/json
400
Invalid condition
application/json
404
Not found
application/json
500
Error
application/json
post
POST /api/v3/site/mid/{mid}/rid/{rid}/sid/{sid}/payment HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 263

{
  "stop_send_email": 1,
  "ftid": 1,
  "skip_ccv": 1,
  "bin_currency": 1,
  "allow_rebilling": 1,
  "proceedeveniffail": 1,
  "margin_percentage": "text",
  "first_transaction_alert": 1,
  "notify_email": "text",
  "allow_refund": 1,
  "allow_refund_time": 1,
  "emaildomain": "text",
  "shipping_n_tracking": 1
}
{
  "msg": "text",
  "details": "text"
}
post
Authorizations
Path parameters
midintegerRequired

Merchant Id that related to retailer and retailer site

ridintegerRequired

Retailer Id that related to retailer site

sidintegerRequired

Retailer Site Id that related retailer site proceed to setup payment info

Body
Responses
200
Successfully setup payment site
application/json
400
Invalid condition
application/json
404
Not found
application/json
500
Error
application/json
post
POST /api/v3/site/mid/{mid}/rid/{rid}/sid/{sid}/3ds HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 971

{
  "settings": {
    "clientMode": "text",
    "enableResult": "text",
    "disableChallenge": "text",
    "enable3ds1Frictionless": "text",
    "enable3DS1Only": "text",
    "requestorName": "text",
    "requestorURL": "text",
    "authenticationInd": "text",
    "challengeInd": "text",
    "acctType": "text",
    "acquirerMerchantPwd": "text",
    "mcc": "text",
    "merchantCountryCode": "text",
    "merchantName": "text",
    "messageCategory": "text",
    "purchaseCurrency": "text",
    "transType": "text",
    "verbose": 1,
    "acquirerBin": "text",
    "acquirerMid": "text",
    "masterAcquirerBin": "text",
    "masterAcquirerMid": "text",
    "JCBAcquirerBin": "text",
    "JCBAcquirerMid": "text",
    "CUPAcquirerBin": "text",
    "CUPAcquirerMid": "text",
    "AMEXAcquirerBin": "text",
    "AMEXAcquirerMid": "text"
  },
  "shieldsettings": {
    "skip3d2": 1,
    "three_ds_provider": "text",
    "threedsprotocolversion": "text",
    "paayauth3d2": "text",
    "gpay_merchant_token": "text",
    "gpay_merchant_id": "text",
    "gpay_base_url": "text",
    "hitrust_account_id": "text",
    "hitrust_password": "text",
    "hitrust_base_url": "text",
    "hitrust_mastercard_prefix": "text"
  }
}
{
  "msg": "text",
  "details": "text"
}
post
Authorizations
Path parameters
midintegerRequired

Merchant Id that related to retailer and retailer site

ridintegerRequired

Retailer Id that related to retailer site

sidintegerRequired

Retailer Site Id that related retailer site proceed to setup alert info

Body
alertapiurlstringOptional
descriptoridstringOptional
usernamestringOptional
tokenstringOptional
default_dispute_actionstringOptional

one of the value from [match,match_n_refund]

max_refund_amountintegerOptional
alert_triggeremailintegerOptional

allowed for 0 or 1 only

alert_emailstringOptional
shieldrdr_review_emailstringOptional
statusupdate_urlstringOptional
Responses
200
Successfully setup alert site
application/json
400
Invalid condition
application/json
404
Not found
application/json
500
Error
application/json
post
POST /api/v3/site/mid/{mid}/rid/{rid}/sid/{sid}/alert HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 233

{
  "alertapiurl": "text",
  "descriptorid": "text",
  "username": "text",
  "token": "text",
  "default_dispute_action": "text",
  "max_refund_amount": 1,
  "alert_triggeremail": 1,
  "alert_email": "text",
  "shieldrdr_review_email": "text",
  "statusupdate_url": "text"
}
{
  "msg": "text",
  "details": "text"
}