Get hosted checkout status
Hosted Checkouts
Using hostedCheckouts you can process transactions using MyCheckout, our easy to use hosted responsive payment pages. Your consumers will be able to complete the payment process using MyCheckout that is hosted by us. Using these pages to capture card details and process card transactions will greatly reduce not only your integration efforts, but it will also reduce your 'PCI exposure' to the lowest level (SAQ-A).
The layout and look and feel of the MyCheckout Pages can be managed through the Configuration Center. Here you will find the powerful, yet very intuitive MyCheckout editor that lets you create multiple variations of your hosted payment pages hosted by us. If you have created multiple versions you are able to direct your consumers to specific variants through this API. This allows you easily test out different variations or continue specific campaigns all the way through to the payment pages.
The MyCheckout pages automatically adapt based on screen width of your consumers device. Clients that do not support JavaScript to be run on the client will still be able to make payments (although they will lack all the client side validation and automatic formatting to assist them). Please note that both the responsive nature and the support for clients without JavaScript support might not apply to 3rd party payment pages that the consumer might be redirected to to complete the payment.
MyCheckout is also modular in its setup, allowing you to specify exactly what you want us to do as part of your checkout flow. You decide if we should display the payment product selection and/or the confirmation page after a successful payment.
In case a payment product that requires the consumer to (manually) push the funds was selected, you will have the option to show these instructions again at a later moment. You could show them on your website in an area where the consumer can track the progress of their order. To avoid multiple payments you should however avoid showing them again for transactions that have already been paid.
Request
You can retrieve the current status of the hosted checkout by doing a get on the hostedCheckoutId. When a payment has been created during the hosted checkout session the details are returned in this object.
Request example
This scenario you will probably use the most
-
$response = $client->v1()->merchant('merchantId')->hostedcheckouts()->get('hostedCheckoutId');
Responses
In case the hostedCheckoutId has not yet expired the response to the GET request will contain the status of the hosted checkout. In case the consumer has also made a payment during the session a createdPaymentOutput object is returned containing the details of the created payment object. Please note that for payments that involve a redirect to a 3rd party, like iDeal or PayPal, the payment might not have been completed at the moment you retrieved the status. This is indicated by the status contained in the createdPaymentOutput object.
Response 200 - OKGetHostedCheckoutResponse
The request was processed correctly and a valid response is returned. In case a payment was created during the hosted checkout the details are returned in the createdPaymentOutput object.
Properties
|
|||
Property | Type | Required | Details |
---|---|---|---|
object | no | read close | |
close
DescriptionWhen a payment has been created during the hosted checkout session this object will return the details.
|
|||
object | no | read close | |
close
DescriptionObject that contains the action, including the needed data, that you should perform next, like showing instruction, showing the transaction results or redirect to a third party to complete the payment
|
|||
displayedDataType | enum | no | read close |
close
DescriptionAction merchants needs to take in the online payment process. Possible values are:
|
|||
renderingData | string | no | read close |
close
DescriptionThis property contains the blob with data for the instructions rendering service.
This service will be available at the following endpoint: http(s)://{{merchant specific subdomain}}.{{base MyCheckout hosted payment pages domain}}/instructions/{{merchantId}}/{{clientSessionId}} This instructions page rendering service accepts the following parameters:
The instructionsRenderingData is a String blob that is presented to you via the Server API as part of the merchantAction (if available, and non-redirect) in the JSON return values for the createPayment call or the getHostedCheckoutStatus call (merchantAction inside createdPaymentOutput when available). You are responsible to store the instructionsRenderingData blob in order to be able to present the instructions page at a later time, when this information might no longer be available through Server API calls. |
|||
array of object | no | read close | |
close
DescriptionArray of key value pairs of data that needs to be shown to the customer. This is returned for both the SHOW_INSTRUCTION as well as the SHOW_TRANSACTION_RESULTS actionType.
Note: The returned value for the key BARCODE is a base64 encoded gif image. By prepending 'data:image/gif;base64,' this value can be used as the source of an HTML inline image. |
|||
object | no | read close | |
key | string | no | read close |
close
DescriptionName of the key or property
|
|||
value | string | no | read close |
close
DescriptionValue of the key or property
|
|||
isCheckedRememberMe | boolean | no | read close |
close
DescriptionIndicates whether the customer ticked the "Remember my details for future purchases" checkbox on the MyCheckout hosted payment pages
|
|||
object | no | read close | |
object | no | read close | |
close
DescriptionHosted Checkout specific information. Populated if the payment was created on the GlobalCollect platform through a Hosted Checkout.
|
|||
hostedCheckoutId | string | no | read close |
close
DescriptionThe ID of the Hosted Checkout Session in which the payment was made.
|
|||
variant | string | no | read close |
close
DescriptionUsing the Configuration Center it is possible to create multiple variations of your MyCheckout payment pages. By specifying a specific variant you can force the use of another variant then the default. This allows you to test out the effect of certain changes to your hosted mandate pages in a controlled manner. Please note that you need to specify the ID of the variant.
|
|||
id | string | no | read close |
close
DescriptionOur unique payment transaction identifier.
|
|||
object | no | read close | |
object | no | read close | |
close
DescriptionObject containing amount and ISO currency code attributes
|
|||
amount | integer (12) | yes | read close |
close
DescriptionAmount in cents and always having 2 decimals
|
|||
currencyCode | string (3) | yes | read close |
close
DescriptionThree-letter ISO currency code representing the currency for the amount
|
|||
amountPaid | integer | no | read close |
close
DescriptionAmount that has been paid
|
|||
amountReversed | integer | no | read close |
close
DescriptionAmount that has been reversed
|
|||
object | one of the group | read close | |
close
DescriptionObject containing the bank transfer payment method details
|
|||
object | no | read close | |
fraudServiceResult | string | no | read close |
close
DescriptionResults from the fraud prevention check. Possible values are:
|
|||
object | no | read close | |
close
DescriptionObject containing device fingerprinting details from InAuth
|
|||
deviceCategory | string | no | read close |
close
DescriptionThe type of device used by the customer. Example values:
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
riskScore | string | no | read close |
close
DescriptionThe score calculated on the basis of Anomalies, Velocity, Location, Integrity, List-Based, and Device Reputation. Range of the score is between 0 and 100. A lower value is better.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by inAuth. This might be different from the IP address that you are seeing on your side due to the proxy piercing technology deployed by inAuth.
|
|||
trueIpAddressCountry | string | no | read close |
close
DescriptionThe country of the customer based on the location of the True IP Address determined by inAuth.
|
|||
object | no | read close | |
close
DescriptionThis object contains the results of Microsoft Fraud Protection risk assessment. Microsoft collects transaction data points and uses Adaptive AI that continuously learns to protect you against payment fraud, and the device fingerprinting details from the Microsoft Device Fingerprinting service.
|
|||
clauseName | string | no | read close |
close
DescriptionName of the clause within the applied policy that was triggered during the evaluation of this transaction.
|
|||
deviceCountryCode | string | no | read close |
close
DescriptionThe country of the customer determined by Microsoft Device Fingerprinting.
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
fraudScore | integer | no | read close |
close
DescriptionResult of the Microsoft Fraud Protection check. This contains the normalized fraud score from a scale of 0 to 100. A higher score indicates an increased risk of fraud.
|
|||
policyApplied | string | no | read close |
close
DescriptionName of the policy that was applied on during the evaluation of this transaction.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by Microsoft Device Fingerprinting.
|
|||
userDeviceType | string | no | read close |
close
DescriptionThe type of device used by the customer.
|
|||
paymentProductId | integer | no | read close |
close
DescriptionPayment product identifier
Please see payment products for a full overview of possible values. |
|||
object | one of the group | read close | |
close
DescriptionObject containing the card payment method details
|
|||
authorisationCode | string | no | read close |
close
DescriptionCard Authorization code as returned by the acquirer
|
|||
object | no | read close | |
cardNumber | string (19) | no | read close |
close
DescriptionThe complete credit/debit card number
|
|||
cardholderName | string | no | read close |
close
DescriptionThe card holder's name on the card.
|
|||
expiryDate | string (4) | no | read close |
close
DescriptionExpiry date of the card
Format: MMYY |
|||
object | no | read close | |
close
DescriptionFraud results contained in the CardFraudResults object
|
|||
avsResult | string | no | read close |
close
DescriptionResult of the Address Verification Service checks. Possible values are:
|
|||
cvvResult | string | no | read close |
close
DescriptionResult of the Card Verification Value checks. Possible values are:
|
|||
fraudServiceResult | string | no | read close |
close
DescriptionResulting advice of the fraud prevention checks. Possible values are:
|
|||
object | no | read close | |
close
DescriptionResults of Fraugster fraud prevention check. Fraugster collects transaction data points such as name, email address, billing, etc. to analyze whether or not the transaction is fraudulent.
|
|||
fraudInvestigationPoints | string | no | read close |
close
DescriptionResult of the Fraugster check
Contains the investigation points used during the evaluation
|
|||
fraudScore | integer | no | read close |
close
DescriptionResult of the Fraugster check
Contains the overall Fraud score which is an integer between 0 and 99
|
|||
object | no | read close | |
close
DescriptionObject containing device fingerprinting details from InAuth
|
|||
deviceCategory | string | no | read close |
close
DescriptionThe type of device used by the customer. Example values:
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
riskScore | string | no | read close |
close
DescriptionThe score calculated on the basis of Anomalies, Velocity, Location, Integrity, List-Based, and Device Reputation. Range of the score is between 0 and 100. A lower value is better.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by inAuth. This might be different from the IP address that you are seeing on your side due to the proxy piercing technology deployed by inAuth.
|
|||
trueIpAddressCountry | string | no | read close |
close
DescriptionThe country of the customer based on the location of the True IP Address determined by inAuth.
|
|||
object | no | read close | |
close
DescriptionThis object contains the results of Microsoft Fraud Protection risk assessment. Microsoft collects transaction data points and uses Adaptive AI that continuously learns to protect you against payment fraud, and the device fingerprinting details from the Microsoft Device Fingerprinting service.
|
|||
clauseName | string | no | read close |
close
DescriptionName of the clause within the applied policy that was triggered during the evaluation of this transaction.
|
|||
deviceCountryCode | string | no | read close |
close
DescriptionThe country of the customer determined by Microsoft Device Fingerprinting.
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
fraudScore | integer | no | read close |
close
DescriptionResult of the Microsoft Fraud Protection check. This contains the normalized fraud score from a scale of 0 to 100. A higher score indicates an increased risk of fraud.
|
|||
policyApplied | string | no | read close |
close
DescriptionName of the policy that was applied on during the evaluation of this transaction.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by Microsoft Device Fingerprinting.
|
|||
userDeviceType | string | no | read close |
close
DescriptionThe type of device used by the customer.
|
|||
object | no | read close | |
close
DescriptionAdditional response data returned by RetailDecisions
|
|||
fraudCode | string | no | read close |
close
DescriptionResult of the fraud service.
Provides additional information about the fraud result
|
|||
fraudNeural | string | no | read close |
close
DescriptionReturns the raw score of the neural
|
|||
fraudRCF | string | no | read close |
close
DescriptionResult of the fraud service
Represent sets of fraud rules returned during the evaluation of the transaction
|
|||
initialSchemeTransactionId | string | no | read close |
close
DescriptionThe unique scheme transactionId of the initial transaction that was performed with SCA.
Should be stored by the merchant to allow it to be submitted in future transactions. |
|||
networkTokenUsed | boolean | no | read close |
close
DescriptionIndicates if a network token was used during the payment.
|
|||
paymentProductId | integer | no | read close |
close
DescriptionPayment product identifier
Please see payment products for a full overview of possible values. |
|||
schemeTransactionId | string | no | read close |
close
DescriptionThe unique scheme transactionId of this transaction.
Should be stored by the merchant to allow it to be submitted in future transactions. Use this value in case the initialSchemeTransactionId property is empty. |
|||
object | no | read close | |
acsTransactionId | string | no | read close |
close
DescriptionIdentifier of the authenticated transaction at the ACS/Issuer
|
|||
appliedExemption | string | no | read close |
close
DescriptionExemption code from Carte Bancaire (130) (unknown possible values so far -free format)
|
|||
object | no | read close | |
close
DescriptionThe amount for which this transaction has been authenticated.
|
|||
amount | integer (12) | yes | read close |
close
DescriptionAmount in cents and always having 2 decimals
|
|||
currencyCode | string (3) | yes | read close |
close
DescriptionThree-letter ISO currency code representing the currency for the amount
|
|||
cavv | string | no | read close |
close
DescriptionCAVV or AVV result indicating authentication validation value
|
|||
directoryServerTransactionId | string | no | read close |
close
DescriptionThe 3-D Secure Directory Server transaction ID that is used for the 3D Authentication
|
|||
eci | string | no | read close |
close
DescriptionIndicates Authentication validation results returned after AuthenticationValidation
|
|||
object | no | read close | |
exemptionRaised | string | no | read close |
close
DescriptionType of strong customer authentication (SCA) exemption that was raised towards the acquirer for this transaction.
|
|||
exemptionRejectionReason | string | no | read close |
close
DescriptionThe request exemption could not be granted. The reason why is returned in this property.
|
|||
exemptionRequest | string | no | read close |
close
DescriptionType of strong customer authentication (SCA) exemption requested by you for this transaction.
|
|||
schemeRiskScore | integer | no | read close |
close
DescriptionGlobal score calculated by the Carte Bancaire (130) Scoring platform. Possible values from 0 to 99
|
|||
object | no | read close | |
sdkTransactionId | string | no | read close |
close
DescriptionUniversally unique transaction identifier assigned by the 3-D Secure SDK to identify this transaction.
|
|||
object | no | read close | |
close
DescriptionObject containing data regarding the 3-D Secure authentication
|
|||
acsTransactionId | string (36) | no | read close |
close
DescriptionThe ACS Transaction ID for a prior 3-D Secure authenticated transaction (for example, the first recurring transaction that was authenticated with the customer)
|
|||
method | string | no | read close |
close
DescriptionMethod of authentication used for this transaction.
Possible values:
|
|||
utcTimestamp | string (12) | no | read close |
close
DescriptionTimestamp in UTC (YYYYMMDDHHmm) of the 3-D Secure authentication of this transaction
|
|||
threeDSecureVersion | string | no | read close |
close
DescriptionThe 3-D Secure version used for the authentication.
This property is used in the communication with the acquirer |
|||
threeDServerTransactionId | string | no | read close |
close
DescriptionThe 3-D Secure Server transaction ID that is used for the 3-D Secure version 2 Authentication.
|
|||
xid | string | no | read close |
close
DescriptionTransaction ID for the Authentication
|
|||
token | string | no | read close |
close
DescriptionIf a token was used for or created during the payment, then the ID of that token.
|
|||
object | one of the group | read close | |
close
DescriptionObject containing the cash payment method details
|
|||
object | no | read close | |
fraudServiceResult | string | no | read close |
close
DescriptionResults from the fraud prevention check. Possible values are:
|
|||
object | no | read close | |
close
DescriptionObject containing device fingerprinting details from InAuth
|
|||
deviceCategory | string | no | read close |
close
DescriptionThe type of device used by the customer. Example values:
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
riskScore | string | no | read close |
close
DescriptionThe score calculated on the basis of Anomalies, Velocity, Location, Integrity, List-Based, and Device Reputation. Range of the score is between 0 and 100. A lower value is better.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by inAuth. This might be different from the IP address that you are seeing on your side due to the proxy piercing technology deployed by inAuth.
|
|||
trueIpAddressCountry | string | no | read close |
close
DescriptionThe country of the customer based on the location of the True IP Address determined by inAuth.
|
|||
object | no | read close | |
close
DescriptionThis object contains the results of Microsoft Fraud Protection risk assessment. Microsoft collects transaction data points and uses Adaptive AI that continuously learns to protect you against payment fraud, and the device fingerprinting details from the Microsoft Device Fingerprinting service.
|
|||
clauseName | string | no | read close |
close
DescriptionName of the clause within the applied policy that was triggered during the evaluation of this transaction.
|
|||
deviceCountryCode | string | no | read close |
close
DescriptionThe country of the customer determined by Microsoft Device Fingerprinting.
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
fraudScore | integer | no | read close |
close
DescriptionResult of the Microsoft Fraud Protection check. This contains the normalized fraud score from a scale of 0 to 100. A higher score indicates an increased risk of fraud.
|
|||
policyApplied | string | no | read close |
close
DescriptionName of the policy that was applied on during the evaluation of this transaction.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by Microsoft Device Fingerprinting.
|
|||
userDeviceType | string | no | read close |
close
DescriptionThe type of device used by the customer.
|
|||
paymentProductId | integer | no | read close |
close
DescriptionPayment product identifier
Please see payment products for a full overview of possible values. |
|||
object | one of the group | read close | |
close
DescriptionObject containing the non SEPA direct debit payment method details
|
|||
object | no | read close | |
fraudServiceResult | string | no | read close |
close
DescriptionResults from the fraud prevention check. Possible values are:
|
|||
object | no | read close | |
close
DescriptionObject containing device fingerprinting details from InAuth
|
|||
deviceCategory | string | no | read close |
close
DescriptionThe type of device used by the customer. Example values:
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
riskScore | string | no | read close |
close
DescriptionThe score calculated on the basis of Anomalies, Velocity, Location, Integrity, List-Based, and Device Reputation. Range of the score is between 0 and 100. A lower value is better.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by inAuth. This might be different from the IP address that you are seeing on your side due to the proxy piercing technology deployed by inAuth.
|
|||
trueIpAddressCountry | string | no | read close |
close
DescriptionThe country of the customer based on the location of the True IP Address determined by inAuth.
|
|||
object | no | read close | |
close
DescriptionThis object contains the results of Microsoft Fraud Protection risk assessment. Microsoft collects transaction data points and uses Adaptive AI that continuously learns to protect you against payment fraud, and the device fingerprinting details from the Microsoft Device Fingerprinting service.
|
|||
clauseName | string | no | read close |
close
DescriptionName of the clause within the applied policy that was triggered during the evaluation of this transaction.
|
|||
deviceCountryCode | string | no | read close |
close
DescriptionThe country of the customer determined by Microsoft Device Fingerprinting.
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
fraudScore | integer | no | read close |
close
DescriptionResult of the Microsoft Fraud Protection check. This contains the normalized fraud score from a scale of 0 to 100. A higher score indicates an increased risk of fraud.
|
|||
policyApplied | string | no | read close |
close
DescriptionName of the policy that was applied on during the evaluation of this transaction.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by Microsoft Device Fingerprinting.
|
|||
userDeviceType | string | no | read close |
close
DescriptionThe type of device used by the customer.
|
|||
paymentProductId | integer | no | read close |
close
DescriptionPayment product identifier
Please see payment products for a full overview of possible values. |
|||
object | one of the group | read close | |
close
DescriptionObject containing the e-invoice payment method details
|
|||
object | no | read close | |
fraudServiceResult | string | no | read close |
close
DescriptionResults from the fraud prevention check. Possible values are:
|
|||
object | no | read close | |
close
DescriptionObject containing device fingerprinting details from InAuth
|
|||
deviceCategory | string | no | read close |
close
DescriptionThe type of device used by the customer. Example values:
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
riskScore | string | no | read close |
close
DescriptionThe score calculated on the basis of Anomalies, Velocity, Location, Integrity, List-Based, and Device Reputation. Range of the score is between 0 and 100. A lower value is better.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by inAuth. This might be different from the IP address that you are seeing on your side due to the proxy piercing technology deployed by inAuth.
|
|||
trueIpAddressCountry | string | no | read close |
close
DescriptionThe country of the customer based on the location of the True IP Address determined by inAuth.
|
|||
object | no | read close | |
close
DescriptionThis object contains the results of Microsoft Fraud Protection risk assessment. Microsoft collects transaction data points and uses Adaptive AI that continuously learns to protect you against payment fraud, and the device fingerprinting details from the Microsoft Device Fingerprinting service.
|
|||
clauseName | string | no | read close |
close
DescriptionName of the clause within the applied policy that was triggered during the evaluation of this transaction.
|
|||
deviceCountryCode | string | no | read close |
close
DescriptionThe country of the customer determined by Microsoft Device Fingerprinting.
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
fraudScore | integer | no | read close |
close
DescriptionResult of the Microsoft Fraud Protection check. This contains the normalized fraud score from a scale of 0 to 100. A higher score indicates an increased risk of fraud.
|
|||
policyApplied | string | no | read close |
close
DescriptionName of the policy that was applied on during the evaluation of this transaction.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by Microsoft Device Fingerprinting.
|
|||
userDeviceType | string | no | read close |
close
DescriptionThe type of device used by the customer.
|
|||
object | yes | read close | |
close
DescriptionAfterPay Installments (payment product 9000) specific details
|
|||
installmentId | string | yes | read close |
close
DescriptionThe ID of the installment plan used for the payment.
|
|||
paymentProductId | integer | no | read close |
close
DescriptionPayment product identifier
Please see payment products for a full overview of possible values. |
|||
object | one of the group | read close | |
close
DescriptionObject containing the invoice payment method details
|
|||
object | no | read close | |
fraudServiceResult | string | no | read close |
close
DescriptionResults from the fraud prevention check. Possible values are:
|
|||
object | no | read close | |
close
DescriptionObject containing device fingerprinting details from InAuth
|
|||
deviceCategory | string | no | read close |
close
DescriptionThe type of device used by the customer. Example values:
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
riskScore | string | no | read close |
close
DescriptionThe score calculated on the basis of Anomalies, Velocity, Location, Integrity, List-Based, and Device Reputation. Range of the score is between 0 and 100. A lower value is better.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by inAuth. This might be different from the IP address that you are seeing on your side due to the proxy piercing technology deployed by inAuth.
|
|||
trueIpAddressCountry | string | no | read close |
close
DescriptionThe country of the customer based on the location of the True IP Address determined by inAuth.
|
|||
object | no | read close | |
close
DescriptionThis object contains the results of Microsoft Fraud Protection risk assessment. Microsoft collects transaction data points and uses Adaptive AI that continuously learns to protect you against payment fraud, and the device fingerprinting details from the Microsoft Device Fingerprinting service.
|
|||
clauseName | string | no | read close |
close
DescriptionName of the clause within the applied policy that was triggered during the evaluation of this transaction.
|
|||
deviceCountryCode | string | no | read close |
close
DescriptionThe country of the customer determined by Microsoft Device Fingerprinting.
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
fraudScore | integer | no | read close |
close
DescriptionResult of the Microsoft Fraud Protection check. This contains the normalized fraud score from a scale of 0 to 100. A higher score indicates an increased risk of fraud.
|
|||
policyApplied | string | no | read close |
close
DescriptionName of the policy that was applied on during the evaluation of this transaction.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by Microsoft Device Fingerprinting.
|
|||
userDeviceType | string | no | read close |
close
DescriptionThe type of device used by the customer.
|
|||
paymentProductId | integer | no | read close |
close
DescriptionPayment product identifier
Please see payment products for a full overview of possible values. |
|||
object | one of the group | read close | |
close
DescriptionObject containing the mobile payment method details
|
|||
authorisationCode | string | no | read close |
close
DescriptionCard Authorization code as returned by the acquirer
|
|||
object | no | read close | |
close
DescriptionFraud results contained in the CardFraudResults object
|
|||
avsResult | string | no | read close |
close
DescriptionResult of the Address Verification Service checks. Possible values are:
|
|||
cvvResult | string | no | read close |
close
DescriptionResult of the Card Verification Value checks. Possible values are:
|
|||
fraudServiceResult | string | no | read close |
close
DescriptionResulting advice of the fraud prevention checks. Possible values are:
|
|||
object | no | read close | |
close
DescriptionResults of Fraugster fraud prevention check. Fraugster collects transaction data points such as name, email address, billing, etc. to analyze whether or not the transaction is fraudulent.
|
|||
fraudInvestigationPoints | string | no | read close |
close
DescriptionResult of the Fraugster check
Contains the investigation points used during the evaluation
|
|||
fraudScore | integer | no | read close |
close
DescriptionResult of the Fraugster check
Contains the overall Fraud score which is an integer between 0 and 99
|
|||
object | no | read close | |
close
DescriptionObject containing device fingerprinting details from InAuth
|
|||
deviceCategory | string | no | read close |
close
DescriptionThe type of device used by the customer. Example values:
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
riskScore | string | no | read close |
close
DescriptionThe score calculated on the basis of Anomalies, Velocity, Location, Integrity, List-Based, and Device Reputation. Range of the score is between 0 and 100. A lower value is better.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by inAuth. This might be different from the IP address that you are seeing on your side due to the proxy piercing technology deployed by inAuth.
|
|||
trueIpAddressCountry | string | no | read close |
close
DescriptionThe country of the customer based on the location of the True IP Address determined by inAuth.
|
|||
object | no | read close | |
close
DescriptionThis object contains the results of Microsoft Fraud Protection risk assessment. Microsoft collects transaction data points and uses Adaptive AI that continuously learns to protect you against payment fraud, and the device fingerprinting details from the Microsoft Device Fingerprinting service.
|
|||
clauseName | string | no | read close |
close
DescriptionName of the clause within the applied policy that was triggered during the evaluation of this transaction.
|
|||
deviceCountryCode | string | no | read close |
close
DescriptionThe country of the customer determined by Microsoft Device Fingerprinting.
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
fraudScore | integer | no | read close |
close
DescriptionResult of the Microsoft Fraud Protection check. This contains the normalized fraud score from a scale of 0 to 100. A higher score indicates an increased risk of fraud.
|
|||
policyApplied | string | no | read close |
close
DescriptionName of the policy that was applied on during the evaluation of this transaction.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by Microsoft Device Fingerprinting.
|
|||
userDeviceType | string | no | read close |
close
DescriptionThe type of device used by the customer.
|
|||
object | no | read close | |
close
DescriptionAdditional response data returned by RetailDecisions
|
|||
fraudCode | string | no | read close |
close
DescriptionResult of the fraud service.
Provides additional information about the fraud result
|
|||
fraudNeural | string | no | read close |
close
DescriptionReturns the raw score of the neural
|
|||
fraudRCF | string | no | read close |
close
DescriptionResult of the fraud service
Represent sets of fraud rules returned during the evaluation of the transaction
|
|||
network | string | no | read close |
close
DescriptionThe network that was used for the refund
|
|||
object | no | read close | |
dpan | string (19) | yes | read close |
close
DescriptionThe obfuscated DPAN. Only the last four digits are visible.
|
|||
expiryDate | string (4) | yes | read close |
close
DescriptionExpiry date of the tokenized card
Format: MMYY |
|||
paymentProductId | integer | no | read close |
close
DescriptionPayment product identifier
Please see payment products for a full overview of possible values. |
|||
object | no | read close | |
acsTransactionId | string | no | read close |
close
DescriptionIdentifier of the authenticated transaction at the ACS/Issuer
|
|||
appliedExemption | string | no | read close |
close
DescriptionExemption code from Carte Bancaire (130) (unknown possible values so far -free format)
|
|||
object | no | read close | |
close
DescriptionThe amount for which this transaction has been authenticated.
|
|||
amount | integer (12) | yes | read close |
close
DescriptionAmount in cents and always having 2 decimals
|
|||
currencyCode | string (3) | yes | read close |
close
DescriptionThree-letter ISO currency code representing the currency for the amount
|
|||
cavv | string | no | read close |
close
DescriptionCAVV or AVV result indicating authentication validation value
|
|||
directoryServerTransactionId | string | no | read close |
close
DescriptionThe 3-D Secure Directory Server transaction ID that is used for the 3D Authentication
|
|||
eci | string | no | read close |
close
DescriptionIndicates Authentication validation results returned after AuthenticationValidation
|
|||
object | no | read close | |
exemptionRaised | string | no | read close |
close
DescriptionType of strong customer authentication (SCA) exemption that was raised towards the acquirer for this transaction.
|
|||
exemptionRejectionReason | string | no | read close |
close
DescriptionThe request exemption could not be granted. The reason why is returned in this property.
|
|||
exemptionRequest | string | no | read close |
close
DescriptionType of strong customer authentication (SCA) exemption requested by you for this transaction.
|
|||
schemeRiskScore | integer | no | read close |
close
DescriptionGlobal score calculated by the Carte Bancaire (130) Scoring platform. Possible values from 0 to 99
|
|||
object | no | read close | |
sdkTransactionId | string | no | read close |
close
DescriptionUniversally unique transaction identifier assigned by the 3-D Secure SDK to identify this transaction.
|
|||
object | no | read close | |
close
DescriptionObject containing data regarding the 3-D Secure authentication
|
|||
acsTransactionId | string (36) | no | read close |
close
DescriptionThe ACS Transaction ID for a prior 3-D Secure authenticated transaction (for example, the first recurring transaction that was authenticated with the customer)
|
|||
method | string | no | read close |
close
DescriptionMethod of authentication used for this transaction.
Possible values:
|
|||
utcTimestamp | string (12) | no | read close |
close
DescriptionTimestamp in UTC (YYYYMMDDHHmm) of the 3-D Secure authentication of this transaction
|
|||
threeDSecureVersion | string | no | read close |
close
DescriptionThe 3-D Secure version used for the authentication.
This property is used in the communication with the acquirer |
|||
threeDServerTransactionId | string | no | read close |
close
DescriptionThe 3-D Secure Server transaction ID that is used for the 3-D Secure version 2 Authentication.
|
|||
xid | string | no | read close |
close
DescriptionTransaction ID for the Authentication
|
|||
object | one of the group | read close | |
close
DescriptionObject containing the redirect payment product details
|
|||
object | no | read close | |
close
DescriptionObject that holds the Basic Bank Account Number (BBAN) data
|
|||
accountHolderName | string (30) | depends | read close |
close
DescriptionName of the account holder
|
|||
accountNumber | string | depends | read close |
close
DescriptionBank account number
|
|||
bankCode | string | depends | read close |
close
DescriptionBank code
|
|||
bankName | string (40) | no | read close |
close
DescriptionName of the bank
|
|||
branchCode | string | no | read close |
close
DescriptionBranch code
|
|||
checkDigit | string | no | read close |
close
DescriptionBank check digit
|
|||
countryCode | string (2) | no | read close |
close
DescriptionISO 3166-1 alpha-2 country code of the country where the bank account is held
For UK payouts this value is automatically set to GB as only payouts to UK accounts are supported.
|
|||
object | no | read close | |
close
DescriptionObject containing account holder name and IBAN information
|
|||
accountHolderName | string (30) | depends | read close |
close
DescriptionName in which the account is held.
|
|||
iban | string (50) | depends | read close |
close
DescriptionThe IBAN is the International Bank Account Number. It is an internationally agreed format for the BBAN and includes the ISO country code and two check digits.
|
|||
bic | string | no | read close |
close
DescriptionThe BIC is the Business Identifier Code, also known as SWIFT or Bank Identifier code. It is a code with an internationally agreed format to Identify a specific bank or even branch. The BIC contains 8 or 11 positions: the first 4 contain the bank code, followed by the country code and location code.
|
|||
object | no | read close | |
fraudServiceResult | string | no | read close |
close
DescriptionResults from the fraud prevention check. Possible values are:
|
|||
object | no | read close | |
close
DescriptionObject containing device fingerprinting details from InAuth
|
|||
deviceCategory | string | no | read close |
close
DescriptionThe type of device used by the customer. Example values:
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
riskScore | string | no | read close |
close
DescriptionThe score calculated on the basis of Anomalies, Velocity, Location, Integrity, List-Based, and Device Reputation. Range of the score is between 0 and 100. A lower value is better.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by inAuth. This might be different from the IP address that you are seeing on your side due to the proxy piercing technology deployed by inAuth.
|
|||
trueIpAddressCountry | string | no | read close |
close
DescriptionThe country of the customer based on the location of the True IP Address determined by inAuth.
|
|||
object | no | read close | |
close
DescriptionThis object contains the results of Microsoft Fraud Protection risk assessment. Microsoft collects transaction data points and uses Adaptive AI that continuously learns to protect you against payment fraud, and the device fingerprinting details from the Microsoft Device Fingerprinting service.
|
|||
clauseName | string | no | read close |
close
DescriptionName of the clause within the applied policy that was triggered during the evaluation of this transaction.
|
|||
deviceCountryCode | string | no | read close |
close
DescriptionThe country of the customer determined by Microsoft Device Fingerprinting.
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
fraudScore | integer | no | read close |
close
DescriptionResult of the Microsoft Fraud Protection check. This contains the normalized fraud score from a scale of 0 to 100. A higher score indicates an increased risk of fraud.
|
|||
policyApplied | string | no | read close |
close
DescriptionName of the policy that was applied on during the evaluation of this transaction.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by Microsoft Device Fingerprinting.
|
|||
userDeviceType | string | no | read close |
close
DescriptionThe type of device used by the customer.
|
|||
object | no | read close | |
close
DescriptionPostFinance Card (payment product 3201) specific details
|
|||
object | no | read close | |
cardNumber | string (19) | no | read close |
close
DescriptionThe complete credit/debit card number
|
|||
cardholderName | string | no | read close |
close
DescriptionThe card holder's name on the card.
|
|||
expiryDate | string (4) | no | read close |
close
DescriptionExpiry date of the card
Format: MMYY |
|||
object | no | read close | |
close
DescriptionTrustly (payment product 806) specific details
|
|||
object | no | read close | |
close
DescriptionObject containing the billing address details of the customer
|
|||
additionalInfo | string (50) | no | read close |
close
DescriptionAdditional address information. The additionalInfo is truncated after 10 characters for payments, refunds or payouts that are processed by the WL Online Payment Acceptance platform
|
|||
city | string | depends | read close |
close
DescriptionCity
Note: For payments with product 1503 the maximum length is not 40 but 20. |
|||
countryCode | string (2) | no depends no yes no | read close |
close
DescriptionISO 3166-1 alpha-2 country code
|
|||
houseNumber | string (15) | depends | read close |
close
DescriptionHouse number. The houseNumber is truncated after 10 characters for payments, refunds or payouts that are processed by the WL Online Payment Acceptance platform
|
|||
state | string (35) | no | read close |
close
DescriptionFull name of the state or province
|
|||
stateCode | string | depends | read close |
close
DescriptionISO 3166-2 alpha-3 state code
Notes:
|
|||
street | string (50) | depends | read close |
close
DescriptionStreetname
|
|||
zip | string | depends | read close |
close
DescriptionZip code
Note: For payments with product 1503 the maximum length is not 10 but 8. |
|||
object | no | read close | |
accountLastDigits | string | no | read close |
close
DescriptionThe last digits of the account number
|
|||
bankName | string | no | read close |
close
DescriptionThe name of the bank
|
|||
clearinghouse | string | no | read close |
close
DescriptionThe country of the clearing house
|
|||
personIdentificationNumber | string | no | read close |
close
DescriptionThe ID number of the account holder
|
|||
object | no | read close | |
close
DescriptionSofort (payment product 836) specific details
|
|||
securityIndicator | string | no | read close |
close
DescriptionIndicates if SofortBank could estabilish if the transaction could successfully be processed.
|
|||
object | no | read close | |
close
DescriptionPayPal (payment product 840) specific details
|
|||
object | no | read close | |
close
DescriptionObject containing the billing address details of the customer
|
|||
additionalInfo | string (50) | no | read close |
close
DescriptionAdditional address information. The additionalInfo is truncated after 10 characters for payments, refunds or payouts that are processed by the WL Online Payment Acceptance platform
|
|||
city | string | depends | read close |
close
DescriptionCity
Note: For payments with product 1503 the maximum length is not 40 but 20. |
|||
countryCode | string (2) | no depends no yes no | read close |
close
DescriptionISO 3166-1 alpha-2 country code
|
|||
houseNumber | string (15) | depends | read close |
close
DescriptionHouse number. The houseNumber is truncated after 10 characters for payments, refunds or payouts that are processed by the WL Online Payment Acceptance platform
|
|||
state | string (35) | no | read close |
close
DescriptionFull name of the state or province
|
|||
stateCode | string | depends | read close |
close
DescriptionISO 3166-2 alpha-3 state code
Notes:
|
|||
street | string (50) | depends | read close |
close
DescriptionStreetname
|
|||
zip | string | depends | read close |
close
DescriptionZip code
Note: For payments with product 1503 the maximum length is not 10 but 8. |
|||
object | no | read close | |
close
DescriptionObject containing the details of the PayPal account
|
|||
accountId | string | no | read close |
close
DescriptionUsername with which the PayPal account holder has registered at PayPal
|
|||
billingAgreementId | string | no | read close |
close
DescriptionIdentification of the PayPal recurring billing agreement
|
|||
companyName | string | no | read close |
close
DescriptionName of the company in case the PayPal account is owned by a business
|
|||
contactPhone | string | no | read close |
close
DescriptionThe phone number of the PayPal account holder
|
|||
countryCode | string | no | read close |
close
DescriptionCountry where the PayPal account is located
|
|||
customerAccountStatus | string | no | read close |
close
DescriptionStatus of the PayPal account.
Possible values are:
|
|||
customerAddressStatus | string | no | read close |
close
DescriptionStatus of the customer's shipping address as registered by PayPal
Possible values are:
|
|||
firstName | string | no | read close |
close
DescriptionFirst name of the PayPal account holder
|
|||
payerId | string | no | read close |
close
DescriptionThe unique identifier of a PayPal account and will never change in the life cycle of a PayPal account
|
|||
surname | string | no | read close |
close
DescriptionSurname of the PayPal account holder
|
|||
object | no | read close | |
additionalInfo | string (50) | no | read close |
close
DescriptionAdditional address information. The additionalInfo is truncated after 10 characters for payments, refunds or payouts that are processed by the WL Online Payment Acceptance platform
|
|||
city | string | depends | read close |
close
DescriptionCity
Note: For payments with product 1503 the maximum length is not 40 but 20. |
|||
countryCode | string (2) | no depends no yes no | read close |
close
DescriptionISO 3166-1 alpha-2 country code
|
|||
houseNumber | string (15) | depends | read close |
close
DescriptionHouse number. The houseNumber is truncated after 10 characters for payments, refunds or payouts that are processed by the WL Online Payment Acceptance platform
|
|||
state | string (35) | no | read close |
close
DescriptionFull name of the state or province
|
|||
stateCode | string | depends | read close |
close
DescriptionISO 3166-2 alpha-3 state code
Notes:
|
|||
street | string (50) | depends | read close |
close
DescriptionStreetname
|
|||
zip | string | depends | read close |
close
DescriptionZip code
Note: For payments with product 1503 the maximum length is not 10 but 8. |
|||
object | no | read close | |
close
DescriptionProtection Eligibility data of the PayPal customer
|
|||
eligibility | string | no | read close |
close
DescriptionPossible values:
|
|||
type | string | no | read close |
close
DescriptionPossible values:
|
|||
paymentProductId | integer | no | read close |
close
DescriptionPayment product identifier
Please see payment products for a full overview of possible values. |
|||
token | string | no | read close |
close
DescriptionID of the token. This property is populated when the payment was done with a token or when the payment was tokenized.
|
|||
object | one of the group | read close | |
close
DescriptionObject containing the SEPA direct debit details
|
|||
object | no | read close | |
fraudServiceResult | string | no | read close |
close
DescriptionResults from the fraud prevention check. Possible values are:
|
|||
object | no | read close | |
close
DescriptionObject containing device fingerprinting details from InAuth
|
|||
deviceCategory | string | no | read close |
close
DescriptionThe type of device used by the customer. Example values:
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
riskScore | string | no | read close |
close
DescriptionThe score calculated on the basis of Anomalies, Velocity, Location, Integrity, List-Based, and Device Reputation. Range of the score is between 0 and 100. A lower value is better.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by inAuth. This might be different from the IP address that you are seeing on your side due to the proxy piercing technology deployed by inAuth.
|
|||
trueIpAddressCountry | string | no | read close |
close
DescriptionThe country of the customer based on the location of the True IP Address determined by inAuth.
|
|||
object | no | read close | |
close
DescriptionThis object contains the results of Microsoft Fraud Protection risk assessment. Microsoft collects transaction data points and uses Adaptive AI that continuously learns to protect you against payment fraud, and the device fingerprinting details from the Microsoft Device Fingerprinting service.
|
|||
clauseName | string | no | read close |
close
DescriptionName of the clause within the applied policy that was triggered during the evaluation of this transaction.
|
|||
deviceCountryCode | string | no | read close |
close
DescriptionThe country of the customer determined by Microsoft Device Fingerprinting.
|
|||
deviceId | string | no | read close |
close
DescriptionThis is the device fingerprint value. Based on the amount of data that the device fingerprint collector script was able to collect, this will be a proxy ID for the device used by the customer.
|
|||
fraudScore | integer | no | read close |
close
DescriptionResult of the Microsoft Fraud Protection check. This contains the normalized fraud score from a scale of 0 to 100. A higher score indicates an increased risk of fraud.
|
|||
policyApplied | string | no | read close |
close
DescriptionName of the policy that was applied on during the evaluation of this transaction.
|
|||
trueIpAddress | string | no | read close |
close
DescriptionThe true IP address as determined by Microsoft Device Fingerprinting.
|
|||
userDeviceType | string | no | read close |
close
DescriptionThe type of device used by the customer.
|
|||
object | yes | read close | |
close
DescriptionOutput that is SEPA Direct Debit specific (i.e. the used mandate)
|
|||
mandateReference | string | no | read close |
close
DescriptionUnique reference to a Mandate
|
|||
paymentProductId | integer | no | read close |
close
DescriptionPayment product identifier
Please see payment products for a full overview of possible values. |
|||
token | string | no | read close |
close
DescriptionID of the token. This property is populated for the GlobalCollect payment platform when the payment was done with a token or when the payment was tokenized.
|
|||
paymentMethod | string | no | read close |
close
DescriptionPayment method identifier used by the our payment engine with the following possible values:
|
|||
object | no | read close | |
close
DescriptionObject that holds all reference properties that are linked to this transaction
|
|||
merchantOrderId | integer | no | read close |
close
DescriptionYour order ID for this transaction that is also returned in our report files
|
|||
merchantReference | string | no | read close |
close
DescriptionYour unique reference of the transaction that is also returned in our report files. This is almost always used for your reconciliation of our report files.
|
|||
paymentReference | string | no | read close |
close
DescriptionPayment Reference generated by WebCollect
|
|||
providerId | string | no | read close |
close
DescriptionProvides an additional means of reconciliation for Gateway merchants
|
|||
providerMerchantId | string | no | read close |
close
DescriptionProvides an additional means of reconciliation, this is the MerchantId used at the provider
|
|||
providerReference | string | no | read close |
close
DescriptionProvides an additional means of reconciliation for Gateway merchants
|
|||
referenceOrigPayment | string | no | read close |
close
DescriptionWhen you did not supply a merchantReference for your payment, you need to fill this property with the reference of the original payment when you want to refund it
|
|||
reversalReason | string | no | read close |
close
DescriptionThe reason description given for the reversedAmount property.
|
|||
status | enum | no | read close |
close
DescriptionCurrent high-level status of the payment in a human-readable form. Possible values are :
Please see Statuses for a full overview of possible values. |
|||
object | no | read close | |
close
DescriptionThis object has the numeric representation of the current payment status, timestamp of last status change and performable action on the current payment resource.
In case of failed payments and negative scenarios, detailed error information is listed.
|
|||
array of object | no | read close | |
close
DescriptionCustom object contains the set of errors
|
|||
object | no | read close | |
category | string | no | read close |
close
DescriptionCategory the error belongs to. The category should give an indication of the type of error you are dealing with.
Possible values:
|
|||
code | string | yes | read close |
close
DescriptionError code
|
|||
httpStatusCode | integer | no | read close |
close
DescriptionHTTP status code for this error that can be used to determine the type of error
|
|||
id | string | no | read close |
close
DescriptionID of the error. This is a short human-readable message that briefly describes the error.
|
|||
message | string | no | read close |
close
DescriptionHuman-readable error message that is not meant to be relayed to customer as it might tip off people who are trying to commit fraud
|
|||
propertyName | string | no | read close |
close
DescriptionReturned only if the error relates to a value that was missing or incorrect.
Contains a location path to the value as a JSonata query. Some common examples:
|
|||
requestId | string | no | read close |
close
DescriptionID of the request that can be used for debugging purposes
|
|||
isAuthorized | boolean | no | read close |
close
DescriptionIndicates if the transaction has been authorized
|
|||
isCancellable | boolean | no | read close |
close
DescriptionFlag indicating if the payment can be cancelled
|
|||
isRefundable | boolean | no | read close |
close
DescriptionFlag indicating if the payment can be refunded
|
|||
isRetriable | boolean | no | read close |
close
DescriptionFlag indicating whether a rejected payment may be retried by the merchant without incurring a fee
|
|||
array of object | no | read close | |
close
DescriptionThis is the raw response returned by the acquirer. This property contains unprocessed data directly returned by the acquirer. It's recommended for data analysis only due to its dynamic nature, which may undergo future changes.
|
|||
object | no | read close | |
key | string | no | read close |
close
DescriptionName of the key or property
|
|||
value | string | no | read close |
close
DescriptionValue of the key or property
|
|||
statusCategory | enum | no | read close |
close
DescriptionHighlevel status of the payment, payout or refund with the following possible values:
Please see Statuses for a full overview of possible values. |
|||
statusCode | integer | no | read close |
close
DescriptionNumeric status code of the legacy API. It is returned to ease the migration from the legacy APIs to Worldline Connect. You should not write new business logic based on this property as it will be deprecated in a future version of the API. The value can also be found in the GlobalCollect Payment Console, in the Ogone BackOffice and in report files.
|
|||
statusCodeChangeDateTime | string | no | read close |
close
DescriptionDate and time of payment
Format: YYYYMMDDHH24MISS |
|||
threeDSecureStatus | enum | no | read close |
close
DescriptionThe 3D Secure status, with the following possible values:
|
|||
object | no | read close | |
close
DescriptionObject containing the created references
|
|||
additionalReference | string | no | read close |
close
DescriptionThe additional reference identifier for this transaction. Data in this property will also be returned in our report files, allowing you to reconcile them.
|
|||
externalReference | string | no | read close |
close
DescriptionThe external reference identifier for this transaction. Data in this property will also be returned in our report files, allowing you to reconcile them.
|
|||
paymentStatusCategory | enum | no | read close |
close
Deprecated:
Use payment.statusOutput.statusCategory instead
DescriptionHighlevel indication of the payment status with the following possible values:
Please see Statuses for a full overview of possible values. |
|||
tokenizationSucceeded | boolean | no | read close |
close
DescriptionIf the payment was attempted to be tokenized, indicates if tokenization was successful or not.
|
|||
tokens | string | no | read close |
close
DescriptionThis property contains the tokens that are associated with the hosted checkout session/customer. You can use the tokens listed in this list for a future checkout of the same customer.
|
|||
status | enum | no | read close |
close
DescriptionThis is the status of the hosted checkout. Possible values are:
Please see Statuses for a full overview of possible values. |
Response example
This scenario you will probably use the most
-
{ "createdPaymentOutput" : { "payment" : { "id" : "000000891566072501680000200001", "hostedCheckoutSpecificOutput" : { "hostedCheckoutId" : "dbcb004a-1eda-4e83-aa47-1656bcdc3e36", "variant" : "100" }, "paymentOutput" : { "amountOfMoney" : { "amount" : 2345, "currencyCode" : "USD" }, "references" : { "paymentReference" : "0" }, "paymentMethod" : "card", "cardPaymentMethodSpecificOutput" : { "paymentProductId" : 1, "authorisationCode" : "123456", "card" : { "cardNumber" : "************7977", "expiryDate" : "1299" }, "fraudResults" : { "avsResult" : "0", "cvvResult" : "M", "fraudServiceResult" : "no-advice" }, "threeDSecureResults" : { "authenticationAmount" : { "currencyCode" : "EUR", "amount" : 2345 } } } }, "status" : "PENDING_APPROVAL", "statusOutput" : { "isCancellable" : true, "statusCode" : 600, "statusCodeChangeDateTime" : "20140717145840", "isAuthorized" : true } }, "paymentCreationReferences" : { "additionalReference" : "00000089156607250168", "externalReference" : "000000891566072501680000200001" }, "tokens" : "" }, "status" : "PAYMENT_CREATED" }
Response 400 - Bad requestErrorResponse
Properties
|
|||
Property | Type | Required | Details |
---|---|---|---|
errorId | string | yes | read close |
close
DescriptionUnique reference, for debugging purposes, of this error response
|
|||
array of object | yes | read close | |
close
DescriptionList of one or more errors
|
|||
object | no | read close | |
category | string | no | read close |
close
DescriptionCategory the error belongs to. The category should give an indication of the type of error you are dealing with.
Possible values:
|
|||
code | string | yes | read close |
close
DescriptionError code
|
|||
httpStatusCode | integer | no | read close |
close
DescriptionHTTP status code for this error that can be used to determine the type of error
|
|||
id | string | no | read close |
close
DescriptionID of the error. This is a short human-readable message that briefly describes the error.
|
|||
message | string | no | read close |
close
DescriptionHuman-readable error message that is not meant to be relayed to customer as it might tip off people who are trying to commit fraud
|
|||
propertyName | string | no | read close |
close
DescriptionReturned only if the error relates to a value that was missing or incorrect.
Contains a location path to the value as a JSonata query. Some common examples:
|
|||
requestId | string | no | read close |
close
DescriptionID of the request that can be used for debugging purposes
|
Response example
This scenario you will probably use the most
-
{ "errorId" : "15eabcd5-30b3-479b-ae03-67bb351c07e6-00000092", "errors" : [ { "code" : "20000000", "propertyName" : "bankAccountBban.accountNumber", "message" : "PARAMETER_NOT_FOUND_IN_REQUEST" } ] }