Service: ExternalPaymentService

Version: 1_25 (other versions, change log, ZUMSTEIN_V4.4-SNAPSHOT) END OF LIFE. Please consider switching to the latest version of the webservices, because this version may be removed anytime from support.

SOAP Demo endpoint: https://myinstit.ws.secutix.com/tnseb/external-remoting/com.secutix.service.realtime.externalpayment.v1_25.ExternalPaymentService.webservice?wsdl

To get the endpoint for your own institution, replace "myinstit" (just after https://) in the url by your own institution code.

For further documentation and examples, please check in Platform Website.external payment service interface v1_25 : web service exposed to external world

Methods:

• cancelPayment:
• checkPayment:
• createAlias:
• createPayment: Creates a payments from the given payment info and parameters.
• getPaymentDetails: Get payment details for payments with the given payment id and/or payments linked to the given order id, or linked to the given operation ids
• getPossiblePayerContacts:
• getPossiblePaymentMethods:
• isExternalPaymentServiceAlive: validate network connection and login/password
• loadAliasOfCustomer:
• notifyPayment:
• removeAlias:
• searchPaymentsByCriteria: Allows to search payments according to a criteria.
• updateAliasData:
• updatePayments:

cancelPayment

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Parameters

requestId	Integer
paymentIds	List of Long

Return value

WebMethodResult
requestId	Integer
statusCode	String (8)
statusDetail	String

checkPayment

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Parameters

requestId	Integer
orderId	Long
payments	List of PaymentInfo

PaymentInfo
amount	Long
cardAlias	String
cardExpirationDate	Date
cardMaskedNumber	String
contactReference	String (20)
paymentIdentifier	String
paymentMethodId	Long
pspAdditionalReturnedData	String
valueDate	Date

Return value

PaymentDetailResult
paymentDetails	List of PaymentDetail
requestId	Integer
statusCode	String (8)
statusDetail	String

PaymentDetail
amount	Long
bankCardOwnerName	String
cardAlias	String
cardExpirationDate	Date
cardMaskedNumber	String
cardType	String
catalogCurrency	CurrencyCash
contactId	Long
contactName	String
contactNumber	String (20)
contactStructureName	String
epcTransactionData	EpcTransactionData
externalUrl	String (255)
isInstallment	boolean
orderId	Long
payerContact	boolean
paymentDate	Date
paymentId	Long
paymentIdentifier	String
paymentLastUpdated	Date
paymentMethod	PaymentMethod
paymentStatus	(WAITING|IN_PROGRESS| AUTHORIZED|PAID| CANCELLED_BY_USER|FAILED| ABANDONED| WAITING_MANUAL_VALIDATION| FAILED_REJECTED)
pspAdditionalReturnedData	String
referenceDate	Date
valueDate	Date

CurrencyCash
availableCash	List of Cash
currencyCode	String (8)
fractionDigit	Integer
minAmount	Integer
symbol	String

Cash
quantity	Integer
type	(COIN|COINS_ROLL|NOTE| NOTES_BUNDLE)
unitAmoung	Integer

EpcTransactionData
aliasPaymentDetails	List of EpcAliasPaymentDetails
postPaymentDetails	EpcPostPaymentDetails
redirectPaymentDetails	List of EpcRedirectPaymentDetails
transactionId	int

EpcAliasPaymentDetails
cardExpMonth	EpcPaymentField
cardExpYear	EpcPaymentField
cardHolder	EpcPaymentField
cardNumber	EpcPaymentField
cvv	EpcPaymentField
paymentMethod	EpcPaymentMethod
hiddenFields	List of EpcField
url	String (255)

EpcPaymentField
definedValues	String
editable	boolean
mandatory	boolean
name	String
value	String

EpcPaymentMethod
cardValidationRegex	String
cvvLength	int
isCvvMandatory	boolean
code	String (8)
description	String

EpcField
name	String
value	String

EpcPostPaymentDetails
cardExpMonth	EpcPaymentField
cardExpYear	EpcPaymentField
cardHolder	EpcPaymentField
cardNumber	EpcPaymentField
cardType	EpcPaymentField
cvv	EpcPaymentField
javascriptLibDetails	List of EpcJavascriptLibDetail
paymentMethods	List of EpcPaymentMethod
storeAlias	EpcPaymentField
hiddenFields	List of EpcField
url	String (255)

EpcJavascriptLibDetail
id	String
url	String (255)

EpcRedirectPaymentDetails
paymentMethod	EpcPaymentMethod
hiddenFields	List of EpcField
url	String (255)

PaymentMethod
changeReturnAllowed	Boolean
code	String (8)
defaultPaymentMethodId	Long
externalDescription	ExternalName	2000 characters max for each translation
externalName	ExternalName	60 characters max for each translation
forPayment	Boolean
forReimbursement	Boolean
id	Long
immediateFollowupPayment	Boolean
inSplitPaymentAllowed	Boolean
internetCode	String (8)	Comma separated list of allowed cards (VISA,AMEX...)
manualValidation	Boolean
maxOrderAmount	Long
minOrderAmount	Long
paymentType	(NUM|CHEQ|CHEQCANCEL|CB| CBCANCEL|PREPAY|VIR|AVR| COUPON|VOUCHER|CTRM|EXT| CA|BVR|INV|CANOAUTH| DEPOSIT|SAPBTRANSF| FIDELITY_POINT|DISCOUNT| CB_WITH_VALIDATION| DIRECT_DEBIT|PREPAYMENT| DIRECT_DEBIT_WITHOUT_INST)
rank	Integer
tooMuchPerceivedAllowed	Boolean
withFollowUp	Boolean

ExternalName
translations	List of Translation

Translation
locale	String (2)
value	String

createAlias

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Parameters

requestId	Integer
pointOfSalesId	Long
contactNumber	String (20)
redirectionUrl	String (255)

Return value

CreateAliasResult
epcPostPaymentDetails	EpcPostPaymentDetails
requestId	Integer
statusCode	String (8)
statusDetail	String

createPayment

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Creates a payments from the given payment info and parameters. Payment parameters clarifications: either the contactId or the contactNumber must be provided. If the contactId field is given, it will be used. Else the contactNumber field will be used. Either a list of operationIds must be provided or an orderId. If the operationIds list is given, those operations will be used. Otherwise all the operations of the order with the given orderId will be used.

Parameters

requestId	Integer
orderId	Long
payments	List of PaymentInfo
paymentParams	PaymentParameters

PaymentParameters
contactId	Long
contactNumber	String (20)
creditCreditNotePayment	boolean
creditWaitingAccountPayment	boolean
operationIds	List of Long
orderId	Long
paymentParametersMap	Map of (RETURN_URL| ORDER_IDENTIFIER| CONTACT_EMAIL), String
pointOfSalesId	Long
remark	String
totalAmount	Long

Return value

PaymentDetailResult

getPaymentDetails

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Get payment details for payments with the given payment id and/or payments linked to the given order id, or linked to the given operation ids

Parameters

requestId	Integer
paymentId	Long
orderId	Long
operationIds	List of Long

Return value

PaymentDetailResult

getPossiblePayerContacts

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Parameters

requestId	Integer
orderIds	List of Long
contactNumbers	List of String

Return value

PossiblePayerContactsResult
contacts	List of ContactData
requestId	Integer
statusCode	String (8)
statusDetail	String

ContactData
Class containing the beneficiary data : contactReference, optional: the secutix contact number firstName, optional: beneficiary first name lastName, optional: beneficiary last name email, optional: beneficiary email birthday, optional: beneficiary birthday firstAddressLine, optional: first address line secondAddressLine, optional: second address line thirdAddressLine, optional: third address line zipCode, optional: address zip code locality, optional: address locality countryCode, optional: address country code phone, optional: beneficary phone number mobilePhone, optional: beneficary mobile phone number contactId, optional: the contact internal id (for internal use by SecuTix only) invoiceAddressId, optional: the contact address internal id idNumber, optional: To store beneficiary id number like passport number. birthRegion, optional: beneficiary birth region birthPlace, optional: beneficiary birth place
answerQuestionnaire	AnswerQuestionnaire
birthPlace	String
birthRegion	String
birthday	Date
contactId	Long
contactReference	String (20)
countryCode	String (8)
email	String
firstAddressLine	String
firstName	String
firstNamePhonetic	String
idNumber	String
invoiceAddressId	Long
lastName	String
lastNamePhonetic	String
locality	String
mobilePhone	String
phone	String
secondAddressLine	String
structureOfficialName	String
thirdAddressLine	String
zipCode	String (8)

AnswerQuestionnaire
answerQuestions	List of AnswerQuestion
ticketId	Long

AnswerQuestion
answerCodes	List of String
questionCode	String (8)

getPossiblePaymentMethods

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Parameters

requestId	Integer
orderId	Long
pointOfSalesId	Long

Return value

PaymentMethodResult
paymentMethods	List of PaymentMethod
requestId	Integer
statusCode	String (8)
statusDetail	String

isExternalPaymentServiceAlive

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

validate network connection and login/password

Parameters

Return value

WebMethodResult

loadAliasOfCustomer

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Parameters

requestId	Integer
pointOfSalesId	Long
contactNumber	String (20)

Return value

LoadAliasResult
epcAliasPaymentDetails	List of EpcAliasPaymentDetails
requestId	Integer
statusCode	String (8)
statusDetail	String

notifyPayment

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Parameters

requestId	Integer
paymentId	Long
maxWaitingTime	Long

Return value

WebMethodResult

removeAlias

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Parameters

requestId	Integer
pointOfSalesId	Long
aliasId	String
contactNumber	String (20)
redirectionUrl	String (255)

Return value

RemoveAliasResult
epcRemoveAliasData	EpcRemoveAliasData
requestId	Integer
statusCode	String (8)
statusDetail	String

EpcRemoveAliasData
hiddenFields	List of EpcField
postUrl	String (255)

searchPaymentsByCriteria

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Allows to search payments according to a criteria.

Parameters

requestId	Integer
searchPaymentsCriteria	SearchPaymentsCriteria	a criteria must be defined, containing at least paymentIds, orderIds or contactReferences.
minIndex	Integer	optional, default : 0
nbMaxResults	Integer	optional, default 10. Max value : 1000

SearchPaymentsCriteria
contactReferences	List of String
orderIds	List of Long
paymentCreationDateFrom	Date
paymentCreationDateTo	Date
paymentIds	List of Long
paymentMethodIds	List of Long
paymentStates	List of (WAITING|IN_PROGRESS| AUTHORIZED|PAID| CANCELLED_BY_USER|FAILED| ABANDONED| WAITING_MANUAL_VALIDATION| FAILED_REJECTED)
paymentTypes	List of (NUM|CHEQ|CHEQCANCEL|CB| CBCANCEL|PREPAY|VIR|AVR| COUPON|VOUCHER|CTRM|EXT| CA|BVR|INV|CANOAUTH| DEPOSIT|SAPBTRANSF| FIDELITY_POINT|DISCOUNT| CB_WITH_VALIDATION| DIRECT_DEBIT|PREPAYMENT| DIRECT_DEBIT_WITHOUT_INST)

Return value

PaymentDetailResult

updateAliasData

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Parameters

requestId	Integer
pointOfSalesId	Long
aliasId	String
contactNumber	String (20)
epcAdditionalData	List of EpcField
redirectionUrl	String (255)

Return value

UpdateAliasResult
epcAliasPaymentDetails	EpcAliasPaymentDetails
requestId	Integer
statusCode	String (8)
statusDetail	String

updatePayments

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Parameters

requestId	Integer
orderId	Long
payments	List of PaymentDetail

Return value

PaymentDetailResult