Site - SID - Payments
Last updated
Last updated
FeeAPI provides a way to get a list of payment methods and information for a given sid. These request should only be used server-to-server as they use the rcode.
FeeAPI will give you the cart converted to the currency of the payment method and the list of payment methods and the fields. Fields section in the response will have the input requirement for sending the transaction to the gateway.
FeeAPI differs from RawFeeAPI in that it requires the cart details. This can be very useful if you want to display the cart details to the customer in the currency that they will be paying.
POST
https://uat.txshield.payshield.ai/soap/feeapi.php
Name | Type | Description |
---|---|---|
RawFeeAPI provides a way to get a list of payment methods and information for a given sid. These request should only be used server-to-server as they use the rcode.
RawFeeAPI will give you the list of payment methods and the fields. Fields section in the response will have the input requirement for sending the transaction to the gateway.
RawFeeAPI differs from FeeAPI in that it does not need the cart details.
POST
https://uat.txshield.payshield.ai/soap/rawfeeapi.php
retrieves a collection of payment options that are available for this sid.
POST
https://uat.txshield.payshield.ai/api/v1/index.php/{sid}/flagcapture
Mark an AUTH transaction as finalised and ready to be captured.
Will search for all transactions done for the given card number either in the last 3 months, or in the month specified.
Functionally the same as /cardtransactions except that it will email a list of the transactions found to the email address stored against the transaction.
Returns the available funds that the merchant can request to withdraw / have settled to them. Does not do the withdrawal, just the balance.
POST
https://uat.txshield.payshield.ai/api/v3/{sid}/balance
Returns the available funds that the merchant can request to withdraw / have settled to them. Does not do the withdrawal, just the balance.
example json body for the call
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
amount_coupon*
String
Coupon amount
(numerical index)*
Array
Contains information about one item in the cart (Repeat until all cart items are listed)
addfee
Boolean
This will add the processing fees on top of the amount.
amount_shipping*
String
Shipping amount
country*
String
Country of the user - will provide the list of payments available for that country
items*
Array
Contains the cart items
amount_purchase*
String
Total amount of purchase
summary*
Array
Contains a summary of cart contents
fxrate_posted*
String
Rate used for conversion of cart currency to gw currency. Enter Buy cart currency Sell Gw currency
sid*
String
Site id (unique identifier for the web site)
currency_code*
String
3 digit currency code of the cart currency
rcode*
String
Site RCODE
cart*
Array
Information about the purchase items. This is only compulsory for feeapi, do not sent the cart to rawfeeapi.
amount_tax*
String
tax amount
item_desc*
String
Item description
item_no*
String
Article number
amount_unit*
String
Unit price amount (without commas and only 2 decimals places)
quantity*
String
Quantity of the item
name*
String
Category, can be used freely
sid*
String
Site id (unique identifier for the web site)
currency*
String
3 digit currency code. cart currency
country*
String
Country of the user - will provide the list of payments available for that country
rcode*
String
Site RCODE
sid*
Integer
Site ID
parent_txid*
String
The parent txid from the Auth transcation.
amount*
Decimal
The amount to capture. Should be the same as the original amount in the Auth transaction.
hash*
String
The md5 hash of sid+amount+rcode
sid*
String
The sid that you want to check the balance of.
object*
String
The root json object.
rcode
String
the rcode for the sid.
search card transactions in month and year
card number masked or unmasked
first six digits of card number
last four digits of card number
month and year of the transaction ddyyyy
Lookup result
tid sent through with the transaction
Transaction id
Each Transaction has a unique id. The parent transaction is the transaction that groups all transaction together.
Has the value "OK" for a successful transaction, "EXC" for a failed transaction, "PEND" for a transaction in progress.
The state change txaction, e.g. "PAYMENT", "REFUND"
The amount of the transaction
The currency of the transaction
Merchant reference
your reference 1
your reference 2
your reference 3
your reference 4
This is a sha256 hash so the data can be verified. Generate sha256 hash of the string of sid;rcode;txid;status;amount;currency;txaction
search card transactions in month and year
card number masked or unmasked
first six digits of card number
last four digits of card number
month and year of the transaction ddyyyy
Lookup result
tid sent through with the transaction
Transaction id
Each Transaction has a unique id. The parent transaction is the transaction that groups all transaction together.
Has the value "OK" for a successful transaction, "EXC" for a failed transaction, "PEND" for a transaction in progress.
The state change txaction, e.g. "PAYMENT", "REFUND"
The amount of the transaction
The currency of the transaction
Merchant reference
your reference 1
your reference 2
your reference 3
your reference 4
This is a sha256 hash so the data can be verified. Generate sha256 hash of the string of sid;rcode;txid;status;amount;currency;txaction
Lookup which payment options from the provider. depending on the country and the payby type used with the sid
ID of site
Country of the user - will provide the list of payments available for that country
Lookup result
This is the paymethod value to use in the "tx" API call
The Cart shipping amount
The Cart discount amount
The Cart tax amount
Transaction currency, ISO 3 letter code
Lookup payment option and convert the cart currency based on your BIN. This is for credit card only.
ID of site
md5 hash of sid+timestamp+amounttotal+currency+rcode e.g. md5('22'.'1234568995265421'.'17.00'.'USD'.'222b6c')
timestamp value used in the hash e.g. 1234568995265421
First 6 digits of the credit card
This will add the processing fees on top of the amount.
The Cart quantities for each line item
The Cart name for each line item
The Cart description for each line item
The Cart amount per unit for each line item
The Cart shipping amount
The Cart discount amount
The Cart tax amount
Transaction currency, ISO 3 letter code
Lookup result
This is the paymethod value to use in the "tx" API call
The Cart shipping amount
The Cart discount amount
The Cart tax amount
Transaction currency, ISO 3 letter code
Create a payout Transaction
ID of site
md5 hash of sid+timestamp+amounttotal+currency+rcode e.g. md5('22'.'1234568995265421'.'17.00'.'USD'.'222b6c')
timestamp value used in the hash e.g. 1234568995265421
Merchant reference
The card number
2 digit for the month. Please have leading zeroes e.g. 05
4 digit year i.e. 2016
The name printed on the card
First name of the customer.
Last name of the customer.
Email of the customer.
Phone of the customer. Please not most payment providers require this.
Billing street address
Billing suburb or city
Billing state, 2 letter code for US/Canada. Australia should use 2/3 letter codes.
Billing country, ISO 3166 2 digit code.
Billing postcode/zipcode.
The payout amount
Transaction currency, ISO 3 letter code
The URL of the page to recieve the postback.
New transaction result
Transaction id
Each Transaction has a unique id. The parent transaction is the transaction that groups all transaction together.
Has the value "OK" for a successful transaction, "EXC" for a failed transaction, "PEND" for a transaction in progress.
The state change txaction, e.g. "PAYMENT", "REFUND"
The amount of the transaction
The currency of the transaction
Merchant reference
The error code, if status value equal "EXC".
The error message, if status value equal "EXC".
This is a sha256 hash so the data can be verified. Generate sha256 hash of the string of sid;rcode;txid;status;amount;currency;txaction
Create a Transaction by converting incoming amount to the descriptor currency
ID of site
md5 hash of sid+timestamp+amounttotal+currency+rcode e.g. md5('22'.'1234568995265421'.'17.00'.'USD'.'222b6c')
timestamp value used in the hash e.g. 1234568995265421
Merchant reference
Which paymethod to use. Look at the "getPaymentOptions" API call to see what paymethods are available and what payment fields need completeting.
The card number
The card 3/4 digit verification code
2 digit for the month. Please have leading zeroes e.g. 05
4 digit year i.e. 2016
The name printed on the card
First name of the customer.
Last name of the customer.
Email of the customer.
Phone of the customer. Please not most payment providers require this.
Billing street address
Billing suburb or city
Billing state, 2 letter code for US/Canada. Australia should use 2/3 letter codes.
Billing country, ISO 3166 2 digit code.
Billing postcode/zipcode.
Shipping street address
Shipping suburb or city
Shipping state, 2 letter code for US/Canada. Australia should use 2/3 letter codes.
Shipping country, ISO 3166 2 digit code.
Shipping postcode/zipcode.
The Cart quantities for each line item
The Cart name for each line item
The Cart description for each line item
The Cart amount per unit for each line item
The Cart shipping amount
The Cart discount amount
The Cart tax amount
Transaction currency, ISO 3 letter code
Transaction action eg, PAYMENT, PREAUTH
The URL of the page to recieve the postback.
New transaction result
Transaction id
Each Transaction has a unique id. The parent transaction is the transaction that groups all transaction together.
Has the value "OK" for a successful transaction, "EXC" for a failed transaction, "PEND" for a transaction in progress.
The state change txaction, e.g. "PAYMENT", "REFUND"
The amount of the transaction
The currency of the transaction
Merchant reference
The error code, if status value equal "EXC".
The error message, if status value equal "EXC".
This is a sha256 hash so the data can be verified. Generate sha256 hash of the string of sid;rcode;txid;status;amount;currency;txaction
Create a single Transaction
ID of site
md5 hash of sid+timestamp+amounttotal+currency+rcode e.g. md5('22'.'1234568995265421'.'17.00'.'USD'.'222b6c')
timestamp value used in the hash e.g. 1234568995265421
Merchant reference
Which paymethod to use. Look at the "getPaymentOptions" API call to see what paymethods are available and what payment fields need completeting.
The card number
The card 3/4 digit verification code
2 digit for the month. Please have leading zeroes e.g. 05
4 digit year i.e. 2016
The name printed on the card
First name of the customer.
Last name of the customer.
Email of the customer.
Phone of the customer. Please not most payment providers require this.
Billing street address
Billing suburb or city
Billing state, 2 letter code for US/Canada. Australia should use 2/3 letter codes.
Billing country, ISO 3166 2 digit code.
Billing postcode/zipcode.
Shipping street address
Shipping suburb or city
Shipping state, 2 letter code for US/Canada. Australia should use 2/3 letter codes.
Shipping country, ISO 3166 2 digit code.
Shipping postcode/zipcode.
The Cart quantities for each line item
The Cart name for each line item
The Cart description for each line item
The Cart amount per unit for each line item
The Cart shipping amount
The Cart discount amount
The Cart tax amount
Transaction currency, ISO 3 letter code
Transaction action eg, PAYMENT, PREAUTH
The URL of the page to recieve the postback.
New transaction result
Transaction id
Each Transaction has a unique id. The parent transaction is the transaction that groups all transaction together.
Has the value "OK" for a successful transaction, "EXC" for a failed transaction, "PEND" for a transaction in progress.
The state change txaction, e.g. "PAYMENT", "REFUND"
The amount of the transaction
The currency of the transaction
Merchant reference
The error code, if status value equal "EXC".
The error message, if status value equal "EXC".
This is a sha256 hash so the data can be verified. Generate sha256 hash of the string of sid;rcode;txid;status;amount;currency;txaction
Create a fraudcheck
ID of site
md5 hash of sid+timestamp+amounttotal+currency+rcode e.g. md5('22'.'1234568995265421'.'17.00'.'USD'.'222b6c')
timestamp value used in the hash e.g. 1234568995265421
Merchant reference
type of card(visa/mastercard)
The card number
2 digit for the month. Please have leading zeroes e.g. 05
4 digit year i.e. 2016
The name printed on the card
json string containing 3ds2 check values
First name of the customer.
Last name of the customer.
Email of the customer.
Phone of the customer.
Billing street address
Billing suburb or city
Billing state, 2 letter code for US/Canada. Australia should use 2/3 letter codes.
Billing country, ISO 3166 2 digit code.
Billing postcode/zipcode.
Shipping street address
Shipping suburb or city
Shipping state, 2 letter code for US/Canada. Australia should use 2/3 letter codes.
Shipping country, ISO 3166 2 digit code.
Shipping postcode/zipcode.
Amount
Transaction currency, ISO 3 letter code
New transaction result
Transaction id
Each Transaction has a unique id. The parent transaction is the transaction that groups all transaction together.
Has the value "OK" for a successful transaction, "EXC" for a failed transaction, "PEND" for a transaction in progress.
The state change txaction, e.g. "PAYMENT", "REFUND"
The amount of the transaction
The currency of the transaction
Merchant reference
The error code, if status value equal "EXC".
The error message, if status value equal "EXC".
This is a sha256 hash so the data can be verified. Generate sha256 hash of the string of sid;rcode;txid;status;amount;currency;txaction