Payment
An instance of a credit/debit card payment.
Examples
Create Payment
PaymentsApi.PUBLIC_KEY = "YOUR_PUBLIC_API_KEY";
PaymentsApi.PRIVATE_KEY = "YOUR_PRIVATE_API_KEY";
Payment payment = Payment.create(new PaymentsMap()
.set("amount", 1000L)
.set("card.cvc", "123")
.set("card.expMonth", 8)
.set("card.expYear", 99)
.set("card.number", "5555555555554444")
.set("description", "payment description")
.set("invoice", "[INVOICE ID]")
);
if ("APPROVED".equals(payment.get("paymentStatus"))) {
System.out.println("Payment approved");
}
require 'simplify'
Simplify::public_key = "YOUR_PUBLIC_API_KEY"
Simplify::private_key = "YOUR_PRIVATE_API_KEY"
payment = Simplify::Payment.create({
"amount" => "1000",
"description" => "payment description",
"invoice" => "[INVOICE ID]",
"card" => {
"number" => "5555555555554444",
"expMonth" => "8",
"cvc" => "123",
"expYear" => "99"
}
})
if payment['paymentStatus'] == 'APPROVED'
puts "Payment approved"
end
import simplify
simplify.public_key = "YOUR_PUBLIC_API_KEY"
simplify.private_key = "YOUR_PRIVATE_API_KEY"
payment = simplify.Payment.create({
"amount" : "1000",
"description" : "payment description",
"invoice" : "[INVOICE ID]",
"card" : {
"number" : "5555555555554444",
"expMonth" : "8",
"cvc" : "123",
"expYear" : "99"
}
})
if payment.paymentStatus == 'APPROVED':
print("Payment approved")
<?php
require_once("./lib/Simplify.php");
Simplify::$publicKey = 'YOUR_PUBLIC_API_KEY';
Simplify::$privateKey = 'YOUR_PRIVATE_API_KEY';
$payment = Simplify_Payment::createPayment(array(
'amount' => '1000',
'description' => 'payment description',
'invoice' => '[INVOICE ID]',
'card' => array(
'number' => '5555555555554444',
'expMonth' => '8',
'cvc' => '123',
'expYear' => '99'
)
));
if ($payment->paymentStatus == 'APPROVED') {
echo "Payment approved\n";
}
?>
use Net::Simplify;
$Net::Simplify::public_key = "YOUR_PUBLIC_API_KEY";
$Net::Simplify::private_key = "YOUR_PRIVATE_API_KEY";
my $payment = Net::Simplify::Payment->create({
amount => "1000",
description => "payment description",
invoice => "[INVOICE ID]",
card => {
number => "5555555555554444",
expMonth => "8",
cvc => "123",
expYear => "99"
}
});
print "Payment status ", $payment->{paymentStatus}, "\n";
using SimplifyCommerce.Payments;
PaymentsApi.PublicApiKey = "YOUR_PUBLIC_KEY";
PaymentsApi.PrivateApiKey = "YOUR_PRIVATE_KEY";
PaymentsApi api = new PaymentsApi();
Payment payment = new Payment();
payment.Amount = 1000;
Card card = new Card();
card.Cvc = "123";
card.ExpMonth = 8;
card.ExpYear = 99;
card.Number = "5555555555554444";
payment.Card = card;
payment.Description = "payment description";
payment.Invoice = "[INVOICE ID]";
try
{
payment = (Payment)api.Create(payment);
}
catch (Exception e)
{
Console.WriteLine(e.ToString());
}
var Simplify = require("simplify-commerce"),
client = Simplify.getClient({
publicKey: 'YOUR_PUBLIC_API_KEY',
privateKey: 'YOUR_PRIVATE_API_KEY'
});
client.payment.create({
amount : "1000",
description : "payment description",
invoice : "[INVOICE ID]",
card : {
number : "5555555555554444",
expMonth : "8",
cvc : "123",
expYear : "99"
}
}, function(errData, data){
if(errData){
console.error("Error Message: " + errData.data.error.message);
// handle the error
return;
}
console.log("Payment Status: " + data.paymentStatus);
});
Create Payment
PaymentsApi.PUBLIC_KEY = "YOUR_PUBLIC_API_KEY";
PaymentsApi.PRIVATE_KEY = "YOUR_PRIVATE_API_KEY";
Payment payment = Payment.create(new PaymentsMap()
.set("amount", 2500)
.set("authorization", "[AUTHORIZATION ID]")
.set("currency", "USD")
.set("description", "shipment of two eggs in a glass bottle")
.set("reference", "BCK2THEST")
.set("replayId", "A-77633219")
);
if ("APPROVED".equals(payment.get("paymentStatus"))) {
System.out.println("Payment approved");
}
require 'simplify'
Simplify::public_key = "YOUR_PUBLIC_API_KEY"
Simplify::private_key = "YOUR_PRIVATE_API_KEY"
payment = Simplify::Payment.create({
"authorization" => "[AUTHORIZATION ID]",
"reference" => "BCK2THEST",
"amount" => "2500",
"description" => "shipment of two eggs in a glass bottle",
"currency" => "USD",
"replayId" => "A-77633219"
})
if payment['paymentStatus'] == 'APPROVED'
puts "Payment approved"
end
import simplify
simplify.public_key = "YOUR_PUBLIC_API_KEY"
simplify.private_key = "YOUR_PRIVATE_API_KEY"
payment = simplify.Payment.create({
"authorization" : "[AUTHORIZATION ID]",
"reference" : "BCK2THEST",
"amount" : "2500",
"description" : "shipment of two eggs in a glass bottle",
"currency" : "USD",
"replayId" : "A-77633219"
})
if payment.paymentStatus == 'APPROVED':
print("Payment approved")
<?php
require_once("./lib/Simplify.php");
Simplify::$publicKey = 'YOUR_PUBLIC_API_KEY';
Simplify::$privateKey = 'YOUR_PRIVATE_API_KEY';
$payment = Simplify_Payment::createPayment(array(
'authorization' => '[AUTHORIZATION ID]',
'reference' => 'BCK2THEST',
'amount' => '2500',
'description' => 'shipment of two eggs in a glass bottle',
'currency' => 'USD',
'replayId' => 'A-77633219'
));
if ($payment->paymentStatus == 'APPROVED') {
echo "Payment approved\n";
}
?>
use Net::Simplify;
$Net::Simplify::public_key = "YOUR_PUBLIC_API_KEY";
$Net::Simplify::private_key = "YOUR_PRIVATE_API_KEY";
my $payment = Net::Simplify::Payment->create({
authorization => "[AUTHORIZATION ID]",
reference => "BCK2THEST",
amount => "2500",
description => "shipment of two eggs in a glass bottle",
currency => "USD",
replayId => "A-77633219"
});
print "Payment status ", $payment->{paymentStatus}, "\n";
using SimplifyCommerce.Payments;
PaymentsApi.PublicApiKey = "YOUR_PUBLIC_KEY";
PaymentsApi.PrivateApiKey = "YOUR_PRIVATE_KEY";
PaymentsApi api = new PaymentsApi();
Payment payment = new Payment();
payment.Amount = 2500;
payment.Authorization = new Authorization("[AUTHORIZATION ID]");
payment.Currency = "USD";
payment.Description = "shipment of two eggs in a glass bottle";
payment.Reference = "BCK2THEST";
payment.ReplayId = "A-77633219";
try
{
payment = (Payment)api.Create(payment);
}
catch (Exception e)
{
Console.WriteLine(e.ToString());
}
var Simplify = require("simplify-commerce"),
client = Simplify.getClient({
publicKey: 'YOUR_PUBLIC_API_KEY',
privateKey: 'YOUR_PRIVATE_API_KEY'
});
client.payment.create({
authorization : "[AUTHORIZATION ID]",
reference : "BCK2THEST",
amount : "2500",
description : "shipment of two eggs in a glass bottle",
currency : "USD",
replayId : "A-77633219"
}, function(errData, data){
if(errData){
console.error("Error Message: " + errData.data.error.message);
// handle the error
return;
}
console.log("Payment Status: " + data.paymentStatus);
});
Create a payment from a card token.
PaymentsApi.PUBLIC_KEY = "YOUR_PUBLIC_API_KEY";
PaymentsApi.PRIVATE_KEY = "YOUR_PRIVATE_API_KEY";
Payment payment = Payment.create(new PaymentsMap()
.set("amount", 1000)
.set("currency", "USD")
.set("description", "payment description")
.set("reference", "7a6ef6be31")
.set("token", "[TOKEN ID]")
);
if ("APPROVED".equals(payment.get("paymentStatus"))) {
System.out.println("Payment approved");
}
require 'simplify'
Simplify::public_key = "YOUR_PUBLIC_API_KEY"
Simplify::private_key = "YOUR_PRIVATE_API_KEY"
payment = Simplify::Payment.create({
"reference" => "7a6ef6be31",
"amount" => "1000",
"description" => "payment description",
"currency" => "USD",
"token" => "[TOKEN ID]"
})
if payment['paymentStatus'] == 'APPROVED'
puts "Payment approved"
end
import simplify
simplify.public_key = "YOUR_PUBLIC_API_KEY"
simplify.private_key = "YOUR_PRIVATE_API_KEY"
payment = simplify.Payment.create({
"reference" : "7a6ef6be31",
"amount" : "1000",
"description" : "payment description",
"currency" : "USD",
"token" : "[TOKEN ID]"
})
if payment.paymentStatus == 'APPROVED':
print("Payment approved")
<?php
require_once("./lib/Simplify.php");
Simplify::$publicKey = 'YOUR_PUBLIC_API_KEY';
Simplify::$privateKey = 'YOUR_PRIVATE_API_KEY';
$payment = Simplify_Payment::createPayment(array(
'reference' => '7a6ef6be31',
'amount' => '1000',
'description' => 'payment description',
'currency' => 'USD',
'token' => '[TOKEN ID]'
));
if ($payment->paymentStatus == 'APPROVED') {
echo "Payment approved\n";
}
?>
use Net::Simplify;
$Net::Simplify::public_key = "YOUR_PUBLIC_API_KEY";
$Net::Simplify::private_key = "YOUR_PRIVATE_API_KEY";
my $payment = Net::Simplify::Payment->create({
reference => "7a6ef6be31",
amount => "1000",
description => "payment description",
currency => "USD",
token => "[TOKEN ID]"
});
print "Payment status ", $payment->{paymentStatus}, "\n";
using SimplifyCommerce.Payments;
PaymentsApi.PublicApiKey = "YOUR_PUBLIC_KEY";
PaymentsApi.PrivateApiKey = "YOUR_PRIVATE_KEY";
PaymentsApi api = new PaymentsApi();
Payment payment = new Payment();
payment.Amount = 1000;
payment.Currency = "USD";
payment.Description = "payment description";
payment.Reference = "7a6ef6be31";
payment.Token = "[TOKEN ID]";
try
{
payment = (Payment)api.Create(payment);
}
catch (Exception e)
{
Console.WriteLine(e.ToString());
}
var Simplify = require("simplify-commerce"),
client = Simplify.getClient({
publicKey: 'YOUR_PUBLIC_API_KEY',
privateKey: 'YOUR_PRIVATE_API_KEY'
});
client.payment.create({
reference : "7a6ef6be31",
amount : "1000",
description : "payment description",
currency : "USD",
token : "[TOKEN ID]"
}, function(errData, data){
if(errData){
console.error("Error Message: " + errData.data.error.message);
// handle the error
return;
}
console.log("Payment Status: " + data.paymentStatus);
});
INPUT PARAMETERS
amount
Amount of the payment (in the smallest unit of your currency). Example: 100 = $1.00
[min value: 50, max value: 9999900]
optional
authorization
The ID of the authorization being used to capture the payment.
optional
card
Credit or debit card being used to apply the payment to.
optional
card.addressCity
City of the cardholder.
[max length: 50, min length: 2]
optional
card.addressCountry
Country code (ISO-3166-1-alpha-2 code) of residence of the cardholder.
[max length: 2, min length: 2]
optional
card.addressLine1
Address of the cardholder.
[max length: 255]
optional
card.addressLine2
Address of the cardholder if needed.
[max length: 255]
optional
card.addressState
State of residence of the cardholder. State abbreviations should be used.
[max length: 255]
optional
card.addressZip
Postal code of the cardholder. The postal code size is between 5 and 9 in length and only contain numbers or letters.
[max length: 32]
optional
card.cvc
CVC security code of the card. This is the code on the back of the card. Example: 123
optional
card.expMonth
Expiration month of the card. Format is MM. Example: January = 01
[min value: 1, max value: 12]
optional
card.expYear
Expiration year of the card. Format is YY. Example: 2013 = 13
[min value: 0, max value: 99]
optional
card.name
Name as it appears on the card.
[max length: 50, min length: 2]
optional
card.number
Card number as it appears on the card.
[max length: 19, min length: 13]
optional
currency
Currency code (ISO-4217) for the transaction. Must match the currency associated with your account.
[default:
required
USD
]
customer
ID of customer. If specified, card on file of customer will be used.
optional
description
Free form text field to be used as a description of the payment. This field is echoed back with the payment on any find or list operations.
[max length: 1024]
optional
invoice
ID of invoice for which this payment is being made.
optional
invoiceReference
Invoice reference number.
optional
order
Detailed order information.
optional
order.commodityCode
Standard classification code for products and services.
[max length: 5]
optional
order.customer
ID of the customer associated with the order.
optional
order.customerEmail
Customer email address.
optional
order.customerName
Customer name.
optional
order.customerNote
Additional notes provided by the customer.
[max length: 255]
optional
order.customerReference
A merchant reference for the customer.
optional
order.items
Detailed information about individual items contained in the order.
optional
order.items.amount
Cost of the item.
optional
order.items.description
Description of the item.
optional
order.items.name
Item name.
optional
order.items.product
Product information associated with the item.
optional
order.items.quantity
Quantity of the item contained in the order
[min value: 1, max value: 999999, default:
required
1
]
order.items.reference
A merchant reference for the item.
[max length: 255]
optional
order.items.tax
Taxes associated with the item.
optional
order.merchantNote
Additional notes provided by the merchant.
[max length: 255]
optional
order.payment
ID of the payment associated with the order.
optional
order.reference
A merchant reference for the order.
[max length: 255]
optional
order.shippingAddress
Address the products are being shipped to.
optional
order.shippingAddress.city
City, town, or municipality.
[max length: 255, min length: 2]
optional
order.shippingAddress.country
2-character country code.
[max length: 2, min length: 2]
optional
order.shippingAddress.line1
Street address.
[max length: 255]
optional
order.shippingAddress.line2
(Opt) Street address continued.
[max length: 255]
optional
order.shippingAddress.name
Name of the entity being shipped to.
[max length: 255]
optional
order.shippingAddress.state
State or province.
[max length: 255]
optional
order.shippingAddress.zip
Postal code.
[max length: 32]
optional
order.shippingFromAddress
Address the products are being shipped from.
optional
order.shippingFromAddress.city
City, town, or municipality.
[max length: 255, min length: 2]
optional
order.shippingFromAddress.country
2-character country code.
[max length: 2, min length: 2]
optional
order.shippingFromAddress.line1
Street address.
[max length: 255]
optional
order.shippingFromAddress.line2
(Opt) Street address continued.
[max length: 255]
optional
order.shippingFromAddress.name
Name of the entity performing the shipping.
[max length: 255]
optional
order.shippingFromAddress.state
State or province.
[max length: 255]
optional
order.shippingFromAddress.zip
Postal code.
[max length: 32]
optional
order.shippingName
Name of the entity being shipped to.
optional
order.source
Order source.
[default:
required
WEB
]
order.status
Status of the order.
[default:
required
INCOMPLETE
]
reference
Custom reference field to be used with outside systems.
optional
replayId
An identifier that can be sent to uniquely identify a payment request to facilitate retries due to I/O related issues. This identifier must be unique for your account (sandbox or live) across all of your payments. If supplied, we will check for a payment on your account that matches this identifier. If found will attempt to return an identical response of the original request.
[max length: 50, min length: 1]
optional
taxExempt
Specify true to indicate that the payment is tax-exempt.
optional
token
If specified, card associated with card token will be used.
[max length: 255]
optional
OUTPUT
authorization.id
Authorization ID
card.customer.id
Customer ID
card.id
Unique ID of the card associated with the payment
customer.id
Customer ID
id
Payment ID
refunds.id
Unique id of the refund
transactionDetails.id
Transaction details id
amount
Amount of the payment in the smallest unit of your currency. Example: 100 = $1.00
amountRemaining
Amount of the payment less any refunds that have been applied in the smallest unit of your currency. Example: 100 = $1.00
authCode
Payment authorization code
authorization
Authorization associated with a payment if the payment was not captured immediately.
card
Credit or debit card being used to apply the payment to.
card.addressCity
City of the cardholder.
card.addressCountry
Country code (ISO-3166-1-alpha-2 code) of residence of the cardholder.
card.addressLine1
Address of the cardholder.
card.addressLine2
Address of the cardholder if needed.
card.addressState
State of residence of the cardholder. State abbreviations should be used.
card.addressZip
Postal code of the cardholder. The postal code size is between 5 and 9 in length and only contain numbers or letters.
card.customer
Customer associated with the card
card.customer.email
Email address of the customer
card.customer.name
Name of the customer
card.dateCreated
Creation date in UTC millis of the card in the system
card.expMonth
Expiration month of the card. Format is MM. Example: January = 01
card.expYear
Expiration year of the card. Format is YY. Example: 2013 = 13
card.indicator
Card indicator, i.e. DEBIT, CREDIT or CHARGE CARD.
card.indicatorSource
Card indicator source.
card.last4
Last 4 digits of the card number
card.name
Name as appears on the card.
card.type
Type of credit or debit card
currency
Currency code (ISO-4217) for the transaction. Must match the currency associated with your account.
customer
Customer associated with the payment
customer.email
Email address of the customer
customer.name
Name of the customer
dateCreated
Date the payment occurred in UTC millis
declineReason
Decline Reason.
description
Description of payment
disputed
Flag to indicate if there is a dispute on this payment
fee
The fee charged for processing the transaction. This is the summation of a percentage of the transaction's value and a per transaction fee.
feeCurrency
ISO4217 Currency code for the fee.
feeEstimated
Flag indicating whether fees provided are estimated or actual.
paymentDate
Date of payment in UTC millis.
paymentStatus
Payment status.
reference
Custom reference field to be used with outside systems
refunded
Boolean if the payment was refunded or not
refundedFees
The total amount of fees refunded as a result of refund(s) on a payment.
refunds
Refunds associated with this payment
replayId
The replayId that was submitted with the payment create request.
source
The source of the payment (one of ECOMMERCE or VIRTUAL_TERMINAL)
taxExempt
Specify true to indicate that the payment is tax-exempt.
transactionData
Level 2 and 3 data associated with the payment.
transactionDetails
Raw response from the payment processor.
transactionDetails.data
Raw response data from the acquirer.
Examples
List Payment
PaymentsApi.PUBLIC_KEY = "YOUR_PUBLIC_API_KEY";
PaymentsApi.PRIVATE_KEY = "YOUR_PRIVATE_API_KEY";
ResourceList<Payment> payment = Payment.list(new PaymentsMap("max", 30));
System.out.println ("Total: " + payment.getTotal());
for (Payment o: payment.getList()) {
System.out.println(o.toString());
}
require 'simplify'
Simplify::public_key = "YOUR_PUBLIC_API_KEY"
Simplify::private_key = "YOUR_PRIVATE_API_KEY"
val = Simplify::Payment.list({"max" => 30})
puts "Total: #{val['total']}"
val['list'].each do |o|
puts o.inspect
end
import simplify
simplify.public_key = "YOUR_PUBLIC_API_KEY"
simplify.private_key = "YOUR_PRIVATE_API_KEY"
payments = simplify.Payment.list({"max": 30})
print "Total: " + str(payments.total)
for o in payments.list:
print(o)
<?php
require_once("./lib/Simplify.php");
Simplify::$publicKey = 'YOUR_PUBLIC_API_KEY';
Simplify::$privateKey = 'YOUR_PRIVATE_API_KEY';
$payment = Simplify_Payment::listPayment(array("max" => 30));
print "Total: " . $payment->total . "\n";
foreach ($payment->list as $o) {
print_r($o);
}
?>
use Net::Simplify;
$Net::Simplify::public_key = "YOUR_PUBLIC_API_KEY";
$Net::Simplify::private_key = "YOUR_PRIVATE_API_KEY";
$payments = Net::Simplify::Payment->list({max => 30});
print "Total: ", $payments->total, "\n";
foreach my $payment ($payments->list) {
print $payment->{id}, "\n";
}
using SimplifyCommerce.Payments;
PaymentsApi.PublicApiKey = "YOUR_PUBLIC_KEY";
PaymentsApi.PrivateApiKey = "YOUR_PRIVATE_KEY";
PaymentsApi api = new PaymentsApi();
try
{
ResourceList<Payment> payment = (ResourceList<Payment>)api.List(typeof(Payment));
Console.WriteLine ("Total: " + payment.Total);
Console.WriteLine ("List: " + payment.List.ToString());
}
catch (Exception e)
{
Console.WriteLine(e.ToString());
}
var Simplify = require("simplify-commerce"),
client = Simplify.getClient({
publicKey: 'YOUR_PUBLIC_API_KEY',
privateKey: 'YOUR_PRIVATE_API_KEY'
});
client.payment.list({max: 30}, function(errData, data){
if(errData){
console.error("Error Message: " + errData.data.error.message);
// handle the error
return;
}
console.log("Total: " + data.total);
for(var i=0; i < data.list.length; i++){
console.log("Amount: " + data.list[i].amount);
}
});
INPUT PARAMETERS
filter
*Use dateCreatedMin with dateCreatedMax in the same filter if you want to search between two created dates optional
filter.id | Filter by the payment Id |
filter.replayId | Filter by the compoundReplayId |
filter.last4 | Filter by the card number (last 4 digits) |
filter.amount | Filter by the payment amount (in the smallest unit of your currency) |
filter.text | Filter by the description of the payment |
filter.amountMin & filter.amountMax | The filter amountMin must be used with amountMax to find payments with payments amounts between the min and max figures |
filter.dateCreatedMin* | Filter by the minimum created date you are searching for - Date in UTC millis |
filter.dateCreatedMax* | Filter by the maximum created date you are searching for - Date in UTC millis |
filter.deposit | Filter by the deposit id connected to the payment |
filter.customer | Filter using the Id of the customer to find the payments for that customer |
filter.status | Filter by the payment status text |
filter.reference | Filter by the payment reference text |
filter.authCode | Filter by the payment authorization code (Not the authorization ID) |
filter.q | You can use this to filter by the Id, the authCode or the amount of the payment |
*Use dateCreatedMin with dateCreatedMax in the same filter if you want to search between two created dates optional
max
Allows up to a max of 50 list items to return.
[min value: 0, max value: 50, default:
optional
20
]
offset
Used in paging of the list. This is the start offset of the page.
[min value: 0, default:
optional
0
]
sorting
Allows for ascending or descending sorting of the list.
The value is a map between the property name and the sorting direction (either 'asc' for ascending or 'desc' for descending). Sortable properties are:
dateCreated
, createdBy
, amount
, id
, description
, paymentDate
optional
OUTPUT
filter
Filters to apply to the list.
list
Object list
max
Allows up to a max of 50 list items to return.
offset
Used in paging of the list. This is the start offset of the page.
sorting
Allows for ascending or descending sorting of the list.
total
Total number of records available
Examples
Find Payment
PaymentsApi.PUBLIC_KEY = "YOUR_PUBLIC_API_KEY";
PaymentsApi.PRIVATE_KEY = "YOUR_PRIVATE_API_KEY";
Payment payment = Payment.find("4TR6Bc");
System.out.println (payment);
require 'simplify'
Simplify::public_key = "YOUR_PUBLIC_API_KEY"
Simplify::private_key = "YOUR_PRIVATE_API_KEY"
payment = Simplify::Payment.find('4TR6Bc')
puts payment.inspect
import simplify
simplify.public_key = "YOUR_PUBLIC_API_KEY"
simplify.private_key = "YOUR_PRIVATE_API_KEY"
payment = simplify.Payment.find('4TR6Bc')
print(payment)
<?php
require_once("./lib/Simplify.php");
Simplify::$publicKey = 'YOUR_PUBLIC_API_KEY';
Simplify::$privateKey = 'YOUR_PRIVATE_API_KEY';
$obj = Simplify_Payment::findPayment('4TR6Bc');
print_r($obj);
?>
use Net::Simplify;
$Net::Simplify::public_key = "YOUR_PUBLIC_API_KEY";
$Net::Simplify::private_key = "YOUR_PRIVATE_API_KEY";
$payment = Net::Simplify::Payment->find('4TR6Bc');
print $payment->{id}, "\n";
using SimplifyCommerce.Payments;
using Newtonsoft.Json;
PaymentsApi.PublicApiKey = "YOUR_PUBLIC_KEY";
PaymentsApi.PrivateApiKey = "YOUR_PRIVATE_KEY";
PaymentsApi api = new PaymentsApi();
try
{
String id = "1234";
Payment payment = (Payment)api.Find(typeof(Payment), id);
// output all properties
Console.WriteLine(JsonConvert.SerializeObject(payment).ToString());
}
catch (Exception e)
{
Console.WriteLine(e.ToString());
}
var Simplify = require("simplify-commerce"),
client = Simplify.getClient({
publicKey: 'YOUR_PUBLIC_API_KEY',
privateKey: 'YOUR_PRIVATE_API_KEY'
});
client.payment.find("4TR6Bc", function(errData, data){
if(errData){
console.error("Error Message: " + errData.data.error.message);
// handle the error
return;
}
console.log("Success Response: " + JSON.stringify(data));
});
INPUT PARAMETERS
id
Object ID
required
OUTPUT
authorization.id
Authorization ID
card.customer.id
Customer ID
card.id
Unique ID of the card associated with the payment
customer.id
Customer ID
id
Payment ID
refunds.id
Unique id of the refund
transactionDetails.id
Transaction details id
amount
Amount of the payment in the smallest unit of your currency. Example: 100 = $1.00
amountRemaining
Amount of the payment less any refunds that have been applied in the smallest unit of your currency. Example: 100 = $1.00
authCode
Payment authorization code
authorization
Authorization associated with a payment if the payment was not captured immediately.
card
Credit or debit card being used to apply the payment to.
card.addressCity
City of the cardholder.
card.addressCountry
Country code (ISO-3166-1-alpha-2 code) of residence of the cardholder.
card.addressLine1
Address of the cardholder.
card.addressLine2
Address of the cardholder if needed.
card.addressState
State of residence of the cardholder. State abbreviations should be used.
card.addressZip
Postal code of the cardholder. The postal code size is between 5 and 9 in length and only contain numbers or letters.
card.customer
Customer associated with the card
card.customer.email
Email address of the customer
card.customer.name
Name of the customer
card.dateCreated
Creation date in UTC millis of the card in the system
card.expMonth
Expiration month of the card. Format is MM. Example: January = 01
card.expYear
Expiration year of the card. Format is YY. Example: 2013 = 13
card.indicator
Card indicator, i.e. DEBIT, CREDIT or CHARGE CARD.
card.indicatorSource
Card indicator source.
card.last4
Last 4 digits of the card number
card.name
Name as appears on the card.
card.type
Type of credit or debit card
currency
Currency code (ISO-4217) for the transaction. Must match the currency associated with your account.
customer
Customer associated with the payment
customer.email
Email address of the customer
customer.name
Name of the customer
dateCreated
Date the payment occurred in UTC millis
declineReason
Decline Reason.
description
Description of payment
disputed
Flag to indicate if there is a dispute on this payment
fee
The fee charged for processing the transaction. This is the summation of a percentage of the transaction's value and a per transaction fee.
feeCurrency
ISO4217 Currency code for the fee.
feeEstimated
Flag indicating whether fees provided are estimated or actual.
paymentDate
Date of payment in UTC millis.
paymentStatus
Payment status.
reference
Custom reference field to be used with outside systems
refunded
Boolean if the payment was refunded or not
refundedFees
The total amount of fees refunded as a result of refund(s) on a payment.
refunds
Refunds associated with this payment
replayId
The replayId that was submitted with the payment create request.
source
The source of the payment (one of ECOMMERCE or VIRTUAL_TERMINAL)
taxExempt
Specify true to indicate that the payment is tax-exempt.
transactionData
Level 2 and 3 data associated with the payment.
transactionDetails
Raw response from the payment processor.
transactionDetails.data
Raw response data from the acquirer.
INPUT PARAMETERS
id
ID of the payment to be updated.
required
OUTPUT
authorization.id
Authorization ID
card.customer.id
Customer ID
card.id
Unique ID of the card associated with the payment
customer.id
Customer ID
id
Payment ID
refunds.id
Unique id of the refund
transactionDetails.id
Transaction details id
amount
Amount of the payment in the smallest unit of your currency. Example: 100 = $1.00
amountRemaining
Amount of the payment less any refunds that have been applied in the smallest unit of your currency. Example: 100 = $1.00
authCode
Payment authorization code
authorization
Authorization associated with a payment if the payment was not captured immediately.
card
Credit or debit card being used to apply the payment to.
card.addressCity
City of the cardholder.
card.addressCountry
Country code (ISO-3166-1-alpha-2 code) of residence of the cardholder.
card.addressLine1
Address of the cardholder.
card.addressLine2
Address of the cardholder if needed.
card.addressState
State of residence of the cardholder. State abbreviations should be used.
card.addressZip
Postal code of the cardholder. The postal code size is between 5 and 9 in length and only contain numbers or letters.
card.customer
Customer associated with the card
card.customer.email
Email address of the customer
card.customer.name
Name of the customer
card.dateCreated
Creation date in UTC millis of the card in the system
card.expMonth
Expiration month of the card. Format is MM. Example: January = 01
card.expYear
Expiration year of the card. Format is YY. Example: 2013 = 13
card.indicator
Card indicator, i.e. DEBIT, CREDIT or CHARGE CARD.
card.indicatorSource
Card indicator source.
card.last4
Last 4 digits of the card number
card.name
Name as appears on the card.
card.type
Type of credit or debit card
currency
Currency code (ISO-4217) for the transaction. Must match the currency associated with your account.
customer
Customer associated with the payment
customer.email
Email address of the customer
customer.name
Name of the customer
dateCreated
Date the payment occurred in UTC millis
declineReason
Decline Reason.
description
Description of payment
disputed
Flag to indicate if there is a dispute on this payment
fee
The fee charged for processing the transaction. This is the summation of a percentage of the transaction's value and a per transaction fee.
feeCurrency
ISO4217 Currency code for the fee.
feeEstimated
Flag indicating whether fees provided are estimated or actual.
paymentDate
Date of payment in UTC millis.
paymentStatus
Payment status.
reference
Custom reference field to be used with outside systems
refunded
Boolean if the payment was refunded or not
refundedFees
The total amount of fees refunded as a result of refund(s) on a payment.
refunds
Refunds associated with this payment
replayId
The replayId that was submitted with the payment create request.
source
The source of the payment (one of ECOMMERCE or VIRTUAL_TERMINAL)
taxExempt
Specify true to indicate that the payment is tax-exempt.
transactionData
Level 2 and 3 data associated with the payment.
transactionDetails
Raw response from the payment processor.
transactionDetails.data
Raw response data from the acquirer.