PaySecure Pinless Web Services 2023:07:03:07

<back to all web services

POSCardlessRefundRequest

The following routes are available for this service:
POST/POSCardlessRefund
import java.math.*
import java.util.*
import net.servicestack.client.*


@DataContract
open class POSCardlessRefundRequest
{
    @DataMember
    var Credentials:RequestorCredentials? = null

    @DataMember
    var ReferenceKey:String? = null

    @DataMember
    var OriginalReferenceKey:String? = null

    @DataMember
    var Amount:Int? = null

    @DataMember
    var TID:String? = null

    @DataMember
    var MID:String? = null

    @DataMember
    var NetworkRequestData:NetworkRequestData? = null

    /**
    * Local Date Format mmddyyyy. For Example:- 01202017
    */
    @DataMember
    var LocalDate:String? = null

    /**
    * Local Time Format HHmmss. For Example :- 012322
    */
    @DataMember
    var LocalTime:String? = null

    @DataMember
    var MerchantDetails:MerchantDescriptor? = null

    @DataMember
    var Custom1:String? = null

    @DataMember
    var Custom2:String? = null

    @DataMember
    var Custom3:String? = null

    @DataMember
    var Custom4:String? = null

    @DataMember
    var Custom5:String? = null

    @DataMember
    var SignatureHash:String? = null

    @DataMember
    var ExtendedData:ExtendedData? = null
}

open class RequestorCredentials
{
    @Required()
    var MerchantId:String? = null

    @Required()
    var UserName:String? = null

    @Required()
    var Password:String? = null

    @Required()
    var Version:String? = null
}

open class NetworkRequestData
{
    var AliPayPartnerId:String? = null
    var WebHookURL:String? = null
    var OrderTitle:String? = null
    var OrderDetail:String? = null
    var TerminalIP:String? = null
    var OrderNumber:String? = null
}

open class MerchantDescriptor : MerchantDescriptorBase()
{
    var Name:String? = null
    var Address:String? = null
    var City:String? = null
    var State:String? = null
    var Zip:String? = null
    var Country:String? = null
    var CustomerServiceNumber:String? = null
    var MCC:String? = null
    var FNSnum:String? = null
    var Email:String? = null
}

open class MerchantDescriptorBase
{
    var DataElements:MerchantDataElements? = null
}

open class MerchantDataElements
{
    var RefundSettlementTypeDetails:Int? = null
    var SendRecurringPOSEntryModeFeature:Boolean? = null
    var UseOrgPOSCode:Boolean? = null
}

@DataContract
open class ExtendedData
{
    @DataMember
    var Track2DataForEMVTransaction:String? = null

    @DataMember
    var SenderInfo:SenderInfo? = null

    @DataMember
    var CashbackAmount:Int? = null

    @DataMember
    var Network:NetworkName? = null

    @DataMember
    var ReceiverInfo:ReceiverInfo? = null

    @DataMember
    var BillPayGroup:BillPayGroup? = null

    @DataMember
    var WalletData:WalletDescriptor? = null

    @DataMember
    var SecureData:SecureDescriptor? = null

    @DataMember
    var Level2Data:Level2Descriptor? = null

    @DataMember
    var PaymentFacilitatorData:PaymentFacilitatorDescriptor? = null

    @DataMember
    var TokenData:TokenDescriptor? = null

    @DataMember
    var OTPTranId:String? = null

    @DataMember
    var CurrentShipment:Int? = null

    @DataMember
    var TotalShipments:Int? = null

    @DataMember
    var IsTokenRequested:Boolean? = null

    @DataMember
    var CardonFileIndicator:CardonFileIndicatorDescriptor? = null

    @DataMember
    var CardAccountUpdater:CardAccountUpdaterInfo? = null

    @DataMember
    var RetryAttemptCount:Int? = null

    @DataMember
    var TotalAuthAmount:Int? = null

    @DataMember
    var SignatureHashVersion:String? = null

    @DataMember
    var OrderTypeDetail:OrderTypeInfo? = null

    @DataMember
    var BillPayGroupIndicator:BillPayGroupIndicator? = null

    @DataMember
    var ChargeTypeDetail:ChargeTypeInfo? = null

    @DataMember
    var SAFEligible:SAFEligibleFlag? = null
}

open class SenderInfo
{
    var ReferenceNumber:String? = null
    var AccountNumber:String? = null
    /**
    * Name Format FirstName{Space}LastName. For Example :- Alvaro Morata
    */
    var Name:String? = null
    var Address:String? = null
    var City:String? = null
    var State:String? = null
    var Country:String? = null
    /**
    * DateOfBirth Format MMDDYYYY. For Example :- 05051960
    */
    var DateOfBirth:String? = null
    var Zip:String? = null
    var PhoneNumber:String? = null
    var FundingSource:FundingSourceType? = null
}

enum class FundingSourceType
{
    DepositAccount,
    Credit,
    Debit,
    Prepaid,
}

enum class NetworkName
{
    Default,
    Nyce,
    CU24,
    Xcel,
    Star,
    Puls,
    Shzm,
    Visa,
    Mast,
    Disc,
    Amex,
    Alip,
    Upin,
    Stac,
    Stne,
    Maes,
    Intl,
}

open class ReceiverInfo
{
    var ReferenceNumber:String? = null
    var AccountNumber:String? = null
    /**
    * Name Format FirstName{Space}LastName. For Example :- Alvaro Morata
    */
    var Name:String? = null
    var Address:String? = null
    var City:String? = null
    var State:String? = null
    var Country:String? = null
    var Zip:String? = null
    var PhoneNumber:String? = null
}

enum class BillPayGroup
{
    Default,
    Single,
    Recurring,
    Installment,
    Deferred,
}

open class WalletDescriptor
{
    var Type:String? = null
    var EncryptedData:String? = null
    var ApplicationDataHash:String? = null
    var EphemeralPublicKey:String? = null
    var PublicKeyHash:String? = null
    var TransactionId:String? = null
    var Signature:String? = null
    var Version:String? = null
    var ApplicationData:String? = null
    var MerchantIdentifier:String? = null
    var SpecialPayment:String? = null
    var DigitalWalletIndicator:DigitalWalletInfo? = null
}

enum class DigitalWalletInfo
{
    Default,
    Staged,
    Passthrough,
}

open class SecureDescriptor
{
    var CAVV:String? = null
    var SecureTransactionId:String? = null
}

open class Level2Descriptor
{
    var TaxDetails:TaxIndicator? = null
    var MerchantReferenceNumber:String? = null
    var MerchantTaxId:String? = null
    var OrderNumber:String? = null
    var TaxAmount:Int? = null
    var DestinationPostalCode:String? = null
    var ProductDescription:String? = null
}

enum class TaxIndicator
{
    Default,
    NoTaxInfoProvided,
    TaxInfoProvided,
    TaxExemptItem,
}

open class PaymentFacilitatorDescriptor
{
    var PaymentFacilitatorIndicator:String? = null
    var PFPhoneNumber:String? = null
    var SubMerchID:String? = null
    var SellerID:String? = null
}

open class TokenDescriptor
{
    var TokenType:TokenTypes? = null
    var TokenCryptogramData1:String? = null
    var TokenCryptogramData2:String? = null
}

enum class TokenTypes
{
    Default,
    Ucaf,
    Dsrp,
    Ucafdsrp,
    VisaVerified,
    DigitalWallet,
    VisaVerifiedDigitalWallet,
}

open class CardonFileIndicatorDescriptor
{
    var CardonFile:CardonFileInfo? = null
    var StoredCredentialIndicator:StoredCredentialIndicatorInfo? = null
    var TransactionInitiate:TransactionInitiateInfo? = null
    var ScheduleIndicator:ScheduleIndicatorInfo? = null
    var NetworkTransactionId:String? = null
}

enum class CardonFileInfo
{
    Default,
    Supported,
    NotSupported,
}

enum class StoredCredentialIndicatorInfo
{
    Default,
    Initial,
    Subsequent,
}

enum class TransactionInitiateInfo
{
    Default,
    Merchant,
    Terminal,
    Customer,
}

enum class ScheduleIndicatorInfo
{
    Default,
    Scheduled,
    Unscheduled,
}

enum class CardAccountUpdaterInfo
{
    Default,
    Supported,
    NotSupported,
}

enum class OrderTypeInfo
{
    Default,
    Standing,
    Subscription,
}

open class BillPayGroupIndicator
{
    var MITTotalPaymentCount:String? = null
    var MITAmountType:String? = null
    var MITAmount:String? = null
    var MITUniqueID:String? = null
    var MITFrequency:String? = null
    var MITValidationFlag:String? = null
    var MITValidationReference:String? = null
    var MITSequenceIndicator:String? = null
}

enum class ChargeTypeInfo
{
    Default,
    PartialShipment,
    Delayed,
    NoShow,
    Resubmission,
}

enum class SAFEligibleFlag
{
    Default,
    True,
    False,
}

@DataContract
open class POSCardlessRefund : PaysecureResponseInternal()
{
    @DataMember
    var ErrorMessage:String? = null

    @DataMember
    var ErrorCode:String? = null

    @DataMember
    var TranId:String? = null

    @DataMember
    var Network:String? = null

    @DataMember
    var ResponseCode:String? = null

    @DataMember
    var NetworkResponseData:NetworkResponseData? = null
}

@DataContract
open class PaysecureResponseInternal
{
    @DataMember(EmitDefaultValue=false)
    var Timestamps:RequestTimestamps? = null
}

@DataContract
open class RequestTimestamps
{
    @DataMember(EmitDefaultValue=false)
    var AppLayer:InOutTimes? = null

    @DataMember(EmitDefaultValue=false)
    var ParentLookup:InOutTimes? = null

    @DataMember(EmitDefaultValue=false)
    var RetryLookup:InOutTimes? = null

    @DataMember(EmitDefaultValue=false)
    var GetCardData:InOutTimes? = null

    @DataMember(EmitDefaultValue=false)
    var CardTokenize:InOutTimes? = null

    @DataMember(EmitDefaultValue=false)
    var CardEncrypt:InOutTimes? = null

    @DataMember(EmitDefaultValue=false)
    var DBInsert:InOutTimes? = null

    @DataMember(EmitDefaultValue=false)
    var BackendProcess:InOutTimes? = null

    @DataMember(EmitDefaultValue=false)
    var DBUpdate:InOutTimes? = null

    @DataMember(EmitDefaultValue=false)
    var ParentUpdate:InOutTimes? = null

    @DataMember(EmitDefaultValue=false)
    var Network:InOutTimes? = null
}

@DataContract
open class InOutTimes
{
}

open class NetworkResponseData
{
    var AliPayTransId:String? = null
    var AliPayTransactionTime:String? = null
    var ResponseCode:String? = null
    var WeChatPayTransId:String? = null
    var WeChatPayTransactionTime:String? = null
    var WeChatPayOpenId:String? = null
}

Kotlin POSCardlessRefundRequest DTOs

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 /POSCardlessRefund HTTP/1.1 
Host: api.paysecure.acculynk.net 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	Credentials: 
	{
		MerchantId: String,
		UserName: String,
		Password: String,
		Version: String
	},
	ReferenceKey: String,
	OriginalReferenceKey: String,
	Amount: 0,
	TID: String,
	MID: String,
	NetworkRequestData: 
	{
		AliPayPartnerId: String,
		WebHookURL: String,
		OrderTitle: String,
		OrderDetail: String,
		TerminalIP: String,
		OrderNumber: String
	},
	LocalDate: String,
	LocalTime: String,
	MerchantDetails: 
	{
		Name: String,
		Address: String,
		City: String,
		State: String,
		Zip: String,
		Country: String,
		CustomerServiceNumber: String,
		MCC: String,
		FNSnum: String,
		Email: String,
		DataElements: 
		{
			RefundSettlementTypeDetails: 0,
			SendRecurringPOSEntryModeFeature: False,
			UseOrgPOSCode: False
		}
	},
	Custom1: String,
	Custom2: String,
	Custom3: String,
	Custom4: String,
	Custom5: String,
	SignatureHash: String,
	ExtendedData: 
	{
		Track2DataForEMVTransaction: String,
		SenderInfo: 
		{
			ReferenceNumber: String,
			AccountNumber: String,
			Name: String,
			Address: String,
			City: String,
			State: String,
			Country: String,
			DateOfBirth: String,
			Zip: String,
			PhoneNumber: String,
			FundingSource: DepositAccount
		},
		CashbackAmount: 0,
		Network: Default,
		ReceiverInfo: 
		{
			ReferenceNumber: String,
			AccountNumber: String,
			Name: String,
			Address: String,
			City: String,
			State: String,
			Country: String,
			Zip: String,
			PhoneNumber: String
		},
		BillPayGroup: Default,
		WalletData: 
		{
			Type: String,
			EncryptedData: String,
			ApplicationDataHash: String,
			EphemeralPublicKey: String,
			PublicKeyHash: String,
			TransactionId: String,
			Signature: String,
			Version: String,
			ApplicationData: String,
			MerchantIdentifier: String,
			SpecialPayment: String,
			DigitalWalletIndicator: Default
		},
		SecureData: 
		{
			CAVV: String,
			SecureTransactionId: String
		},
		Level2Data: 
		{
			TaxDetails: Default,
			MerchantReferenceNumber: String,
			MerchantTaxId: String,
			OrderNumber: String,
			TaxAmount: 0,
			DestinationPostalCode: String,
			ProductDescription: String
		},
		PaymentFacilitatorData: 
		{
			PaymentFacilitatorIndicator: String,
			PFPhoneNumber: String,
			SubMerchID: String,
			SellerID: String
		},
		TokenData: 
		{
			TokenType: Default,
			TokenCryptogramData1: String,
			TokenCryptogramData2: String
		},
		OTPTranId: String,
		CurrentShipment: 0,
		TotalShipments: 0,
		IsTokenRequested: False,
		CardonFileIndicator: 
		{
			CardonFile: Default,
			StoredCredentialIndicator: Default,
			TransactionInitiate: Default,
			ScheduleIndicator: Default,
			NetworkTransactionId: String
		},
		CardAccountUpdater: Default,
		RetryAttemptCount: 0,
		TotalAuthAmount: 0,
		SignatureHashVersion: String,
		OrderTypeDetail: Default,
		BillPayGroupIndicator: 
		{
			MITTotalPaymentCount: String,
			MITAmountType: String,
			MITAmount: String,
			MITUniqueID: String,
			MITFrequency: String,
			MITValidationFlag: String,
			MITValidationReference: String,
			MITSequenceIndicator: String
		},
		ChargeTypeDetail: Default,
		SAFEligible: Default
	}
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	ErrorMessage: String,
	ErrorCode: String,
	TranId: String,
	Network: String,
	ResponseCode: String,
	NetworkResponseData: 
	{
		AliPayTransId: String,
		AliPayTransactionTime: String,
		ResponseCode: String,
		WeChatPayTransId: String,
		WeChatPayTransactionTime: String,
		WeChatPayOpenId: String
	},
	Timestamps: 
	{
		AppLayer: 
		{
			InTime: 0001-01-01,
			OutTime: 0001-01-01
		},
		ParentLookup: 
		{
			InTime: 0001-01-01,
			OutTime: 0001-01-01
		},
		RetryLookup: 
		{
			InTime: 0001-01-01,
			OutTime: 0001-01-01
		},
		GetCardData: 
		{
			InTime: 0001-01-01,
			OutTime: 0001-01-01
		},
		CardTokenize: 
		{
			InTime: 0001-01-01,
			OutTime: 0001-01-01
		},
		CardEncrypt: 
		{
			InTime: 0001-01-01,
			OutTime: 0001-01-01
		},
		DBInsert: 
		{
			InTime: 0001-01-01,
			OutTime: 0001-01-01
		},
		BackendProcess: 
		{
			InTime: 0001-01-01,
			OutTime: 0001-01-01
		},
		DBUpdate: 
		{
			InTime: 0001-01-01,
			OutTime: 0001-01-01
		},
		ParentUpdate: 
		{
			InTime: 0001-01-01,
			OutTime: 0001-01-01
		},
		Network: 
		{
			InTime: 0001-01-01,
			OutTime: 0001-01-01
		}
	}
}