RSL Payment API

<back to all web services

VoidPayment

The following routes are available for this service:
POST/payments/void/{TransactionId}Perform void transaction
VoidPayment Parameters:
NameParameterData TypeRequiredDescription
TransactionIdpathstringYesTransaction id of the payment transaction to be voided.
Payment Parameters:
NameParameterData TypeRequiredDescription
Amountformdecimal?No
ReferenceNumberformstringNo
TransactionIdformstringNo
IsSuccessformbool?No
TransactionStatusformTransactionStatus?No
ProcessorResponseCodeformstringNo
ProcessorResponseTextformstringNo
GatewayRejectionReasonformGatewayRejectionReason?No
CreatedAtformDateTimeNo
DisputesformList<Dispute>No
CreditCardformCreditCardNo
PayPalDetailsformPayPalDetailsNo
GooglePayformGooglePayDetailsNo
ApplePayformApplePayDetailsNo
SettlementBatchIdformstringNo
PaymentInstrumentTypeformPaymentInstrumentTypeNo
ResponseStatusTypeformResponseStatusTypeNo
ProcessorDeclineTypeformProcessorDeclineType?No
VoidTransactionIdformstringNo
VoidProcessorResponseCodeformstringNo
ProcessedWithNetworkTokenformbool?No
AcquirerReferenceNumberformstringNo
Retriedformbool?No
AchReturnCodeformstringNo
MerchantAccountIdformstringNo
TokenformstringNo
TransactionStatus Enum:
authorization_expired
authorized
authorizing
failed
gateway_rejected
processor_declined
settled
settling
submitted_for_settlement
voided
unrecognized
settlement_confirmed
settlement_declined
settlement_pending
failed_to_submit
submitting_to_braintree
timeout
GatewayRejectionReason Enum:
application_incomplete
avs
avs_and_cvv
cvv
duplicate
excessive_retry
fraud
risk_threshold
three_d_secure
token_issuance
unrecognized
Dispute Parameters:
NameParameterData TypeRequiredDescription
Amountformdecimal?No
CurrencyIsoCodeformstringNo
DateOpenedformDateTime?No
DateWonformDateTime?No
IdformstringNo
KindformDisputeKindNo
ReasonformDisputeReasonNo
PreDisputeProgramformPreDisputeProgramNo
ReceivedDateformDateTime?No
ReplyByDateformDateTime?No
StatusformDisputeStatusNo
CaseNumberformstringNo
PayPalMessagesformList<DisputePayPalMessage>No
ProtectionLevelformDisputeProtectionLevelNo
DisputeKind Enum:
chargeback
pre_arbitration
retrieval
unrecognized
DisputeReason Enum:
cancelled_recurring_transaction
credit_not_processed
duplicate
fraud
general
invalid_account
not_recognized
product_not_received
product_unsatisfactory
transaction_amount_differs
retrieval
PreDisputeProgram Enum:
none
unrecognized
visa_rdr
DisputeStatus Enum:
open
lost
won
unrecognized
accepted
auto_accepted
disputed
expired
DisputePayPalMessage Parameters:
NameParameterData TypeRequiredDescription
MessageformstringNo
SenderformstringNo
SentAtformDateTime?No
DisputeProtectionLevel Enum:
effortless_cbp
standard_cbp
no_protection
CreditCard Parameters:
NameParameterData TypeRequiredDescription
CardTypeformstringNoThe type of the credit card. Possible values: American Express, Carte Blanche, China UnionPay, Diners Club Discover, JCB, Laser, Maestro, MasterCard, Solo, Switch, Visa, Unknown
ExpirationMonthformstringNo
ExpirationYearformstringNo
BinformstringNoThe first 6 digits of the credit card, known as the Bank Identification Number.
LastFourformstringNoThe last 4 digits of the credit card number
UniqueNumberIdentifierformstringNo
CardholderNameformstringNo
TokenformstringNoThe payment method token
IsNetworkTokenizedformbool?No
DebitformCreditCardDebitNo
CreditCardDebit Enum:
yes
no
unknown
PayPalDetails Parameters:
NameParameterData TypeRequiredDescription
RefundIdformstringNo
CaptureIdformstringNo
SellerProtectionStatusformstringNo
PayerStatusformstringNo
PayerLastNameformstringNo
PayerFirstNameformstringNo
PayerIdformstringNo
PayeeEmailformstringNo
PayeeIdformstringNo
TokenformstringNo
AuthorizationIdformstringNo
PaymentIdformstringNo
PayerEmailformstringNo
TransactionFeeAmountformdecimalNo
TransactionFeeCurrencyIsoCodeformstringNo
DescriptionformstringNo
BillingAgreementIdformstringNo
TaxIdformstringNo
TaxIdTypeformstringNo
GooglePayDetails Parameters:
NameParameterData TypeRequiredDescription
SourceCardTypeformstringNo
CustomerIdformstringNo
ExpirationMonthformstringNo
ExpirationYearformstringNo
BinformstringNoThe first 6 digits of the credit card, known as the Bank Identification Number.
GoogleTransactionIdformstringNo
SourceCardLast4formstringNoThe last 4 digits of the credit card number
CardholderNameformstringNo
TokenformstringNoThe payment method token
IsNetworkTokenizedformbool?No
ApplePayDetails Parameters:
NameParameterData TypeRequiredDescription
CardTypeformstringNo
CustomerIdformstringNo
ExpirationMonthformstringNo
ExpirationYearformstringNo
BinformstringNoThe first 6 digits of the credit card, known as the Bank Identification Number.
LastFourformstringNoThe last 4 digits of the credit card number
CardholderNameformstringNo
TokenformstringNoThe payment method token
PaymentInstrumentType Enum:
unknown
paypal_account
credit_card
android_pay_card
apple_pay_card
ResponseStatusType Enum:
Unknown
Success
Fail
SoftFail
ProcessorDeclineType Enum:
Unknown
Soft
Hard

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /payments/void/{TransactionId} HTTP/1.1 
Host: azs-dev-payment-web.azurewebsites.net 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	transactionId: String
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	amount: 0,
	referenceNumber: String,
	transactionId: String,
	isSuccess: False,
	transactionStatus: authorization_expired,
	processorResponseCode: String,
	processorResponseText: String,
	gatewayRejectionReason: application_incomplete,
	createdAt: 0001-01-01,
	disputes: 
	[
		{
			amount: 0,
			currencyIsoCode: String,
			dateOpened: 0001-01-01,
			dateWon: 0001-01-01,
			id: String,
			kind: chargeback,
			reason: cancelled_recurring_transaction,
			preDisputeProgram: none,
			receivedDate: 0001-01-01,
			replyByDate: 0001-01-01,
			status: open,
			caseNumber: String,
			payPalMessages: 
			[
				{
					message: String,
					sender: String,
					sentAt: 0001-01-01
				}
			],
			protectionLevel: effortless_cbp
		}
	],
	creditCard: 
	{
		cardType: String,
		expirationMonth: String,
		expirationYear: String,
		bin: String,
		lastFour: String,
		uniqueNumberIdentifier: String,
		cardholderName: String,
		token: String,
		isNetworkTokenized: False,
		debit: yes
	},
	payPalDetails: 
	{
		refundId: String,
		captureId: String,
		sellerProtectionStatus: String,
		payerStatus: String,
		payerLastName: String,
		payerFirstName: String,
		payerId: String,
		payeeEmail: String,
		payeeId: String,
		token: String,
		authorizationId: String,
		paymentId: String,
		payerEmail: String,
		transactionFeeAmount: 0,
		transactionFeeCurrencyIsoCode: String,
		description: String,
		billingAgreementId: String,
		taxId: String,
		taxIdType: String
	},
	googlePay: 
	{
		sourceCardType: String,
		customerId: String,
		expirationMonth: String,
		expirationYear: String,
		bin: String,
		googleTransactionId: String,
		sourceCardLast4: String,
		cardholderName: String,
		token: String,
		isNetworkTokenized: False
	},
	applePay: 
	{
		cardType: String,
		customerId: String,
		expirationMonth: String,
		expirationYear: String,
		bin: String,
		lastFour: String,
		cardholderName: String,
		token: String
	},
	settlementBatchId: String,
	paymentInstrumentType: unknown,
	responseStatusType: Unknown,
	processorDeclineType: Unknown,
	voidTransactionId: String,
	voidProcessorResponseCode: String,
	processedWithNetworkToken: False,
	acquirerReferenceNumber: String,
	retried: False,
	achReturnCode: String,
	merchantAccountId: String,
	token: String
}