SOAP Interface

SOAP Interface:	Overview
Description	mPAY24 ETP (Electronic Transaction Processing) Interface WebService
Version	1.5
Authentication	HTTP Basic (Username/Password specified by mPAY24)
Transport protocol	SOAP over HTTPS
WSDL location prod.	https://www.mpay24.com/soap/etp/1.5/ETP.wsdl
WSDL location test.	https://test.mpay24.com/soap/etp/1.5/ETP.wsdl
Endpoint prod.	https://www.mpay24.com/app/bin/etpproxy_v15
Endpoint test	https://test.mpay24.com/app/bin/etpproxy_v15

Legend:

Mandatory: All elements with a bold written name and an asterisk are mandatory (e.g. Example*).
Optional: All non-marked elements are optional and can be omitted.

Operations

Operation	Description
`SelectPayment`	Interactive payment interface
`CreatePaymentToken`	Interactive interface for tokenization of sensitive payment data
`AcceptPayment`	Direct payment interface
`ManualCallback`	Process suspended payment
`ManualClear`	Clear transaction(s)
`ManualReverse`	Reversal (not cleared) transaction
`ManualCredit`	Credit already cleared transaction
`AcceptWithdraw`	Direct withdraw interface
`TransactionStatus`	Get transaction status for specified mpayTID or tid
`TransactionConfirmation`	Get transaction confirmation calls for specified mpayTID
`TransactionHistory`	Get all transaction's states for specified mpayTID or the last transaction with the specified TID
`ListNotCleared`	List transactions to be cleared
`ListPaymentMethods`	List available payment methods (for specific pType)
`CreateProfile`	Interactive creation of payment profiles
`ListProfiles`	List stored payment profiles
`DeleteProfile`	Delete stored payment profile
`CreateCustomer`	Create profiles without payment

SelectPayment

Input: SelectPayment

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`mdxi`*	`string`	`Length: 1 - 8192`	MDXI XML structure to provide transaction data

Output: SelectPaymentResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation
`errNo`	`int`	`Length: 1 - 5`	Error number
`errText`	`string`	`Length: 1 - 255`	Further information upon an error
`location`*	`anyURI`	`-`	Redirection location of the customer

CreatePaymentToken

Input: CreatePaymentToken

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`pType`*	`PaymentType`	`-`	Payment type of the transaction
`templateSet`	`string`	`Length: 1 - 255`	Template set name
`style`	`string`	`Length: 1 - 255`	Styling information
`customerID`	`string`	`Length: 1 - 32`	Merchant customer ID
`profileID`	`string`	`Length: 1 - 12`	Profile ID assigned by the customer
`domain`	`string`	`-`	Merchant domain
`language`	`string`	`Length: 2`	Two digits language ISO code

Output: CreatePaymentTokenResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation
`token`	`string`	`-`	Payment token identifier
`apiKey`	`string`	`-`	REST API key
`errNo`	`int`	`Length: 1 - 5`	Error number
`errText`	`string`	`Length: 1 - 255`	Further information upon an error
`location`	`anyURI`	`-`	Redirection location of the customer

AcceptPayment

Input: AcceptPayment

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`tid`*	`string`	`Length: 1 - 32`	Merchant transaction ID
`pType`*	`PaymentType`	`-`	Payment type of the transaction
`payment`*	`Payment`	`-`	Payment specifics
`customerID`	`string`	`Length: 1 - 32`	Merchant customer ID
`customerName`	`string`	`Length: 1 - 50`	Customer name
`order`	`Order`	`-`	Order description
`successURL`	`anyURI`	`Length: 1 - 1024`	URL for customer redirection in case of success
`errorURL`	`anyURI`	`Length: 1 - 1024`	URL for customer redirection in case of error
`confirmationURL`	`anyURI`	`Length: 1 - 1024`	URL for receiving push notifications about the transaction state
`language`	`string`	`Length: 2`	Two digits language ISO code

Output: AcceptPaymentResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation
`mpayTID`	`unsignedLong`	`Length: 1 - 11`	Unique mPAY24 transaction ID
`errNo`	`int`	`Length: 1 - 5`	Error number
`errText`	`string`	`Length: 1 - 255`	Further information upon an error
`location`	`anyURI`	`-`	Redirection location of the customer

ManualCallback

Input: ManualCallback

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`mpayTID`*	`unsignedLong`	`Length: 1 - 11`	Unique mPAY24 transaction ID
`paymentCallback`*	`Callback`	`-`	Callback details of a payment
`order`	`Order`	`-`	Order description

Output: ManualCallbackResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation
`mpayTID`	`unsignedLong`	`Length: 1 - 11`	Unique mPAY24 transaction ID
`errNo`	`int`	`Length: 1 - 5`	Error number
`errText`	`string`	`Length: 1 - 255`	Further information upon an error
`location`	`anyURI`	`-`	Redirection location of the customer

ManualClear

Input: ManualClear

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`clearingDetails`	`ClearingDetails`	`-`	Clearing transaction details

Output: ManualClearResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation
`transaction`	`Transaction`	`-`	Transaction status information

ManualReverse

Input: ManualReverse

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`mpayTID`*	`unsignedLong`	`Length: 1 - 11`	Unique mPAY24 transaction ID

Output: ManualReverseResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation
`transaction`*	`Transaction`	`-`	Transaction status information

ManualCredit

Input: ManualCredit

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`mpayTID`*	`unsignedLong`	`Length: 1 - 11`	Unique mPAY24 transaction ID
`stateID`	`unsignedLong`	`Length: 1 - 11`	Unique ID of a transaction state
`amount`	`unsignedInt`	`Length: 2 - 11`	Amount stated in cents

Output: ManualCreditResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation
`transaction`*	`Transaction`	`-`	Transaction status information

AcceptWithdraw

Input: AcceptWithdraw

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`tid`*	`string`	`Length: 1 - 32`	Merchant transaction ID
`pType`*	`PaymentType`	`-`	Payment type of the transaction
`withdraw`*	`Withdraw`	`-`	Withdraw specifics
`customerID`	`string`	`Length: 1 - 32`	Merchant customer ID
`customerName`	`string`	`Length: 1 - 50`	Customer name
`order`	`Order`	`-`	Order description
`confirmationURL`	`anyURI`	`Length: 1 - 1024`	URL for receiving push notifications about the transaction state
`language`	`string`	`Length: 2`	Two digits language ISO code

Output: AcceptWithdrawResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation
`mpayTID`	`unsignedLong`	`Length: 1 - 11`	Unique mPAY24 transaction ID
`errNo`	`int`	`Length: 1 - 5`	Error number
`errText`	`string`	`Length: 1 - 255`	Further information upon an error

TransactionStatus

Input: TransactionStatus

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`mpayTID`	`unsignedLong`	`Length: 1 - 11`	Unique mPAY24 transaction ID
`tid`	`string`	`Length: 1 - 32`	Merchant transaction ID

Output: TransactionStatusResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation
`parameter`	Parameter	`-`	Basic name/value parameter

TransactionConfirmation

Input: TransactionConfirmation

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`mpayTID`*	`unsignedLong`	`Length: 1 - 11`	Unique mPAY24 transaction ID

Output: TransactionConfirmationResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation
`confirmation`	`Confirmation`	`-`	Confirmation/notification details of a transaction

TransactionHistory

Input: TransactionHistory

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`mpayTID`*	`unsignedLong`	`Length: 1 - 11`	Unique mPAY24 transaction ID

Output: TransactionHistoryResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation
`historyEntry`	`HistoryEntry`	`-`	Entry of the transaction history

ListNotCleared

Input: ListNotCleared

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`begin`	`unsignedInt`	`Length: 1 - 6`	Index of the first element being listed
`size`	`unsignedInt`	`Length: 1 - 3`	Size of returned list
`sortField`	`SortField`	`-`	Field to order result by
`sortType`	`SortType`	`-`	Method to order result
`listInProgress`	`boolean`	`true`, `false`	List transactions which are currently in progress

Output: ListNotClearedResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation
`transactionDetails`	`TransactionDetails`	`-`	Detailed transaction status information
`all`*	`unsignedInt`	`-`	Total number of elements

ListPaymentMethods

Input: ListPaymentMethods

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`pType`	`PaymentType`	`-`	Payment type of the transaction

Output: ListPaymentMethodsResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation
`paymentMethod`	`PaymentMethod`	`-`	Configured payment method
`all`*	`unsignedInt`	`-`	Total number of elements

CreateProfile

Input: CreateProfile

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`mdxi`*	`string`	`Length: 1 - 8192`	MDXI XML structure to provide transaction data

Output: CreateProfileResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation
`errNo`	`int`	`Length: 1 - 5`	Error number
`errText`	`string`	`Length: 1 - 255`	Further information upon an error
`location`	`anyURI`	`-`	Redirection location of the customer

ListProfiles

Input: ListProfiles

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`customerID`	`string`	`Length: 1 - 32`	Merchant customer ID
`expiredBy`	`date`	`YYYY-MM-DD`	Returns only profiles expired until the given date
`begin`	`unsignedInt`	`Length: 1 - 6`	Index of the first element being listed
`size`	`unsignedInt`	`Length: 1 - 3`	Size of returned list

Output: ListProfilesResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation
`profile`	`Profile`	`-`	Customer payment profile
`all`*	`unsignedInt`	`-`	Total number of elements

DeleteProfile

Input: DeleteProfile

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`customerID`*	`string`	`Length: 1 - 32`	Merchant customer ID
`profileID`	`string`	`Length: 1 - 12`	Profile ID assigned by the customer

Output: DeleteProfileResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation

CreateCustomer

Input: CreateCustomer

Element	Type	Restriction	Description
`merchantID`*	`unsignedInt`	`Length: 5`	mPAY24 merchant ID
`pType`*	`PaymentType`	`-`	Payment type of the transaction
`paymentData`*	`Payment`	`-`	Payment specifics
`customerID`	`string`	`Length: 1 - 32`	Merchant customer ID
`customerName`	`string`	`Length: 1 - 50`	Customer name
`billingAddress`	`xml`		the billingAddress of the customer
`language`	`string`	`Length: 2`	Two digits language ISO code

Output: CreateCustomerResponse

Element	Type	Restriction	Description
`status`*	`Status`	`-`	Response status
`returnCode`*	`string`	`Length: 1 - 255`	Return code of the operation
`errNo`	`int`	`Length: 1 - 5`	Error number

Special types

Simple types / enumerations

Element	Type	Restriction	Description
`Status`	`string`	`OK`, `ERROR`	Operation status
`PaymentType`	`string`	`CC`, `MAESTRO`, `EPS`, `PB`, `PSC`, `ELV`, `QUICK`, `GIROPAY`, `PAYPAL`, `BILLPAY`, `INVOICE`, `HP`, `KLARNA`, `SOFORT`, `MASTERPASS`, `TOKEN`, `PROFILE`, `PAYOLUTION`, `ELVSECURE`, `IDEAL`	Possible payment systems
`TxState`	`string`	`INIT`, `AUTHORIZE`, `SUSPENDED`, `REDIRECTED`, `CALLBACK`, `RESERVED`, `EXECUTE`, `BILLED`, `REVOKE`, `CREDITED`, `REJECT`, `ARCHIVED`, `WITHDRAW`, `WITHDRAWN`	Transaction states
`TStatus`	`string`	`NOTFOUND`, `FAILED`, `RESERVED`, `BILLED`, `REVERSED`, `CREDITED`	Transaction status
`ConfirmationStatus`	`string`	`OK`, `ERROR`, `PENDING`, `FAILURE`	Status of the confirmation-url call
`Confirmed`	`string`	`RESERVED`, `BILLED`, `REVERSED`, `CREDITED`, `WITHDRAWN`, `SUSPENDED`, `ERROR`	Transaction status confirmed on the confirmation-url call
`SortField`	`string`	`MPAYTID`, `PTYPE`, `BRAND`, `CURRENCY`, `TID`, `ORDERDESC`, `ORDERNUMBER`, `CURRDATE`, `CURRTIME`	Transaction field to be used for sorting
`SortType`	`string`	`ASC`, `DESC`	Sort type to be used
`AddressMode`	`string`	`READONLY`, `READWRITE`	Address fields modification mode
`Gender`	`string`	`MALE`, `FEMALE`	Person gender

Complex types

Payment

Common payment parameters

Element	Type	Restriction	Description
`amount`*	`unsignedInt`	`Length: 2 - 11`	Amount stated in cents
`currency`*	`string`	`Length: 3`	Three digit ISO currency code
`manualClearing`	`boolean`	`true`, `false`	Enables or disables manual clearing
`useProfile`	`boolean`	`true`, `false`	Enables or disables profile usage
`profileID`	`string`	`Length: 1 - 12`	Profile ID assigned by the customer

PaymentTOKEN

Extention: Payment

Payment with token specific payment parameters

Element	Type	Restriction	Description
`token`*	`string`	`-`	Payment token identifier

PaymentCC

Extention: Payment

CreditCard specific payment parameters

Element	Type	Restriction	Description
`brand`*	`string`	`-`	Brand abbreviation
`identifier`*	`string`	`Length: 1 - 20`	Identifier of the payment system
`expiry`*	`unsignedInt`	`Length: 4 - YYMM`	Expiry date
`cvc`	`string`	`Length: 3 - 4`	CVC
`auth3DS`	`boolean`	`true`, `false`	Enable or disable 3DS authentication

PaymentMAESTRO

Extention: Payment

Maestro specific payment parameters

Element	Type	Restriction	Description
`identifier`*	`string`	`Length: 1 - 20`	Identifier of the payment system
`expiry`*	`unsignedInt`	`Length: 4`	Expiry date

PaymentEPS

Extention: Payment

EPS online bank transfer specific payment parameters

Element	Type	Restriction	Description
`brand`*	`string`	`-`	Brand abbreviation
`bankID`	`unsignedInt`	`Length: 1 - 3`	Bank ID
`bic`	`string`	`Length: 1 - 11`	Bank identifier code of the customer

PaymentPB

Extention: Payment

Paybox specific payment parameters

Element	Type	Restriction	Description
`identifier`*	`string`	`Length: 1 - 20`	Identifier of the payment system
`payDays`	`unsignedInt`	`Length: 1 - 2`
`reserveDays`	`unsignedInt`	`Length: 1 - 2`

PaymentELV

Extention: Payment

Direct debit specific payment parameters

Element	Type	Restriction	Description
`brand`*	`string`	`-`	Brand abbreviation
`iban`*	`string`	`Length: 1 - 34`	International bank account number of the customer
`bic`	`string`	`Length: 1 - 11`	Bank identifier code of the customer
`mandateID`	`string`	`Length: 1 - 35`	Mandate ID of the transaction assigned by the merchant
`dateOfSignature`	`date`	`-`	Date of mandate signature

PaymentGIROPAY

Extention: Payment

Giropay online bank transfer specific payment parameters

Element	Type	Restriction	Description
`iban`	`string`	`Length: 1 - 34`	International bank account number of the customer
`bic`*	`string`	`Length: 1 - 11`	Bank identifier code of the customer

PaymentPAYPAL

Extention: Payment

PayPal specific payment parameters

Element	Type	Restriction	Description
`commit`	`boolean`	`true`, `false`	Used for PayPal Express Checkout
`custom`	`string`	`Length: 1 - 255`	A free-form field for your own use

ProfilePaymentCC

Extention: Payment

CreditCard specific profile payment parameters for interactive payments

Element	Type	Restriction	Description
`cvc`	`string`	`Length: 3 - 4`	CVC
`auth3DS`	`boolean`	`true`, `false`	Enable or disable 3DS authentication

ProfilePaymentELV

Extention: Payment

Direct debit specific profile payment parameters

Element	Type	Restriction	Description
`mandateID`	`string`	`Length: 1 - 35`	Mandate ID of the transaction assigned by the merchant
`dateOfSignature`	`date`	`-`	Date of mandate signature

Withdraw

Common withdraw parameters

Element	Type	Restriction	Description
`amount`*	`unsignedInt`	`Length: 2 - 11`	Amount stated in cents
`currency`*	`string`	`Length: 3`	Three digit ISO country code

WithdrawCC

Extention: Withdraw

CreditCard specific withdraw parameters

Element	Type	Restriction	Description
`brand`*	`string`	`-`	Brand abbreviation
`identifier`*	`string`	`Length: 1 - 20`	Identifier of the payment system
`expiry`*	`unsignedInt`	`Length: 4`	Expiry date

WithdrawMAESTRO

Extention: Withdraw

Maestro Card specific withdraw parameters

Element	Type	Restriction	Description
`identifier`*	`string`	`Length: 1 - 20`	Identifier of the payment system
`expiry`*	`unsignedInt`	`Length: 4`	Expiry date

Item

Shopping cart item

Element	Type	Restriction	Description
`number`	`string`	`Length: 1 - 255`	Shopping cart row number
`productNr`	`string`	`Length: 1 - 255`	Product number for the item
`description`	`string`	`Length: 1 - 255`	Description respectively title
`package`	`string`	`Length: 1 - 255`	Scale size of the item
`quantity`	`unsignedInt`	`Length: 1 - 255`	Quantity of the item ordered
`tax`	`int`	`Length: 2 - 11`	Tax of all units stated in cents
`amount`*	`int`	`Length: 2 - 11`	Amount stated in cents

ShoppingCart

Shopping cart content

Element	Type	Restriction	Description
`item`	`Item`	`-`	Item in the shopping cart
`discount`	`int`	`Length: 2 - 11`	Discount of the total amount
`shippingCosts`	`int`	`Length: 2 - 11`	Shipping costs of the order
`shippingTax`	`int`	`Length: 2 - 11`	Tax amount of the shipping costs
`tax`	`int`	`Length: 2 - 11`	Tax of all units stated in cents

IndustrySpecific

Common industry specific parameters

AirlineTicket

Extention: IndustrySpecific

Industry specific parameters for airline tickets

Element	Type	Restriction	Description
`iataCode`*	`string`	`-`
`ticketID`*	`string`	`-`

Address

Customer address definition

Element	Type	Restriction	Description
`mode`	`AddressMode`	`-`	Editing mode of the address
`name`*	`string`	`Length: 1 - 50`	Customer name
`gender`	`Gender`	`-`	Customer gender
`birthday`	`date`	`-`	Customer birthday
`street`*	`string`	`Length: 1 - 50`	First street line
`street2`	`string`	`Length: 1 - 50`	Second street line
`zip`*	`string`	`Length: 1 - 50`	Zip code
`city`*	`string`	`Length: 1 - 50`	City name
`state`	`string`	`Length: 1 - 40`	State name
`countryCode`*	`string`	`Length: 2`	Country as two digit ISO code
`email`	`string`	`Length: 1 - 64`	Customer e-mail address
`phone`	`string`	`Length: 1 - 20`	Customer phone number

Order

Customer order definition

Element	Type	Restriction	Description
`clientIP`	`string`	`-`	IP address of the customer
`description`	`string`	`Length: 1 - 255`	Description respectively title
`userField`	`string`	`Length: 1 - 100`	User variable (is communicated over the URLs)
`shoppingCart`	`ShoppingCart`	`-`	Shopping cart of the order
`industrySpecific`	`IndustrySpecific`	`-`	Common industry specific parameters
`billing`	`Address`	`-`	Customer address definition for billing
`shipping`	`Address`	`-`	Customer address definition for shipping

Callback

Common payment callback parameters

Element	Type	Restriction	Description
`amount`	`unsignedInt`	`Length: 2 - 11`	Amount stated in cents

CallbackPAYPAL

Extention: Callback

PayPal specific payment callback parameters

Element	Type	Restriction	Description
`cancel`	`boolean`	`true`, `false`

CallbackMASTERPASS

Extention: Callback

MasterPass specific payment callback parameters

Element	Type	Restriction	Description
`cancel`	`boolean`	`true`, `false`

ClearingDetails

Clearing transaction details

Element	Type	Restriction	Description
`mpayTID`*	`unsignedLong`	`Length: 1 - 11`	Unique mPAY24 transaction ID
`amount`	`unsignedInt`	`Length: 2 - 11`	Amount stated in cents
`order`	`Order`	`-`	Order description

Transaction

Transaction status

Element	Type	Restriction	Description
`mpayTID`*	`unsignedLong`	`Length: 1 - 11`	Unique mPAY24 transaction ID
`tStatus`*	`TStatus`	`-`	Defines possible states of a transaction result
`stateID`	`unsignedLong`	`Length: 1 - 11`	Unique ID of a transaction state
`tid`*	`string`	`Length: 1 - 32`	Merchant transaction ID

TransactionDetails

Extention: Transaction

Detailed transaction status

Element	Type	Restriction	Description
`orderDescription`*	`string`	`Length: 1 - 255`	Order description
`pType`*	`PaymentType`	`-`	Payment type of the transaction
`brand`*	`string`	`-`	Brand abbreviation
`amount`*	`unsignedInt`	`Length: 2 - 11`	Amount stated in cents
`currency`*	`string`	`Length: 3`	Three digit ISO country code
`bifStatus`*	`string`	`-`	Status returned by the payment interface

Parameter

Basic name/value parameter

Element	Type	Restriction	Description
`name`*	`string`	`Length: 1 - 50`	Customer name
`value`*	`string`	`Length: 1 - 255`	Parameter value

HistoryEntry

Entries in the transaction history

Element	Type	Restriction	Description
`stateID`*	`unsignedLong`	`Length: 1 - 11`	Unique ID of a transaction state
`parentStateID`	`unsignedLong`	`Length: 1 - 11`	ID of the related parent state
`txState`*	`TxState`	`-`	Transaction state
`amount`*	`unsignedInt`	`Length: 2 - 11`	Amount stated in cents
`timeStamp`*	`dateTime`	`-`	Timestamp of the transaction state
`approvalCode`	`string`	`Length: 1 - 255`	Payment ID or code returned by the acquirer
`errNo`	`int`	`Length: 1 - 5`	Error number
`errText`	`string`	`Length: 1 - 255`	Further information upon an error
`profileStatus`*	`string`	`-`	Profile status of the action

Confirmation

Results of a confirmation-url call

Element	Type	Restriction	Description
`status`*	`ConfirmationStatus`	`-`	Response status
`confirmed`*	`Confirmed`	`-`	Confirmed transaction status
`timeStamp`*	`dateTime`	`-`	Timestamp of the transaction state
`url`*	`anyURI`	`Length: 1 - 1024`	URL for receiving push notifications about the transaction state
`result`*	`string`	`Length: 0 - 255`	Merchant response of the confirmation receipt

PaymentMethod

Configured payment method

Element	Type	Restriction	Description
`pType`*	`PaymentType`	`-`	Payment type of the transaction
`brand`*	`string`	`-`	Brand abbreviation
`description`*	`string`	`Length: 1 - 255`	Description respectively title

PaymentProfile

Payment profile details

Element	Type	Restriction	Description
`pMethodID`	`unsignedInt`	`Length: 1 - 3`	ID of the payment method
`profileID`*	`string`	`Length: 1 - 12`	Profile ID assigned by the customer
`updated`*	`dateTime`	`-`	Timestamp of the last update
`identifier`*	`string`	`Length: 1 - 20`	Identifier of the payment system
`expires`	`date`	`-`	Expiry date if applicable
`address`	`Address`	`-`

Profile

Customer profile with payment data

Element	Type	Restriction	Description
`customerID`*	`string`	`Length: 1 - 32`	Merchant customer ID
`updated`*	`dateTime`	`-`	Timestamp of the last update
`payment`	`PaymentProfile`	`-`	Payment specifics