FundingInformation: Difference between revisions

From Barion Documentation
Jump to navigation Jump to search
No edit summary
 
(4 intermediate revisions by 3 users not shown)
Line 6: Line 6:


This structure is used by the following API endpoints:
This structure is used by the following API endpoints:
* [[Payment-GetPaymentState-v2]]
* [[Payment-PaymentState-v4]]


= Property list =
= Property list =
Line 16: Line 16:
| AuthorizationCode || string || The authorization code received by the card processing system when executing the payment. If authorization was not successful, this is empty.
| AuthorizationCode || string || The authorization code received by the card processing system when executing the payment. If authorization was not successful, this is empty.
|-
|-
| ProcessResult || string || The result of the last card payment attempt. If there was no charge attempt, this is empty.<br>Possible values:
| ProcessResult || string || The result of the '''last''' card payment attempt (even if it was unsuccessful). If there was no charge attempt, this is empty.<br>Possible values:
* <b>Successful</b>: the card transaction was successful
* <b>Successful</b>: the card transaction was successful
* <b>ProblemWithCard</b>: the card transaction was unsuccessful: card number, CVC or/and expiry is wrong. The card may have been stolen, deleted, disabled or disabled for online transactions.
* <b>ProblemWithCard</b>: the card transaction was unsuccessful: card number, CVC or/and expiry is wrong. The card may have been stolen, deleted, disabled or disabled for online transactions.
Line 24: Line 24:
* <b>FraudulentTransaction</b>: potentially fraudulent transaction, the monitoring system declined the transaction
* <b>FraudulentTransaction</b>: potentially fraudulent transaction, the monitoring system declined the transaction
* <b>CardSystemError</b>: the card transaction failed due to the card system
* <b>CardSystemError</b>: the card transaction failed due to the card system
* <b>SoftDeclined</b>: the payment card did not support SCA at the time of the transaction
* <b>ScaSoftDeclined</b>: the payment card did not support SCA at the time of the transaction
* <b>FailedDuringAuthentication</b>: there was an  error during the SCA process thus authentication failed. This may not be returned if ChallengePreference was set to "NoChallengeNeeded"
* <b>FailedDuringAuthentication</b>: there was an  error during the SCA process thus authentication failed. This may not be returned if ChallengePreference was set to "NoChallengeNeeded"
* <b>CardNotSupported</b>: the payment card is not supported at the time of the transaction - NOT AVAILABLE
* <b>CardNotSupported</b>: the payment card is not supported at the time of the transaction
* <b>SystemError</b>: system error, in this case we try to refund the transaction amount if we have enough information to initiate it - NOT AVAILABLE
* <b>Unknown</b>: the bank system did not provide information about the operation, the result of the process could not be determined
* <b>Unknown</b>: the bank system did not provide information about the operation, the result of the process could not be determined
* <b>ThreeDsNotEnabled</b>: Legacy error, not used any more. Could occur in case of older payments, where 3ds was not enabled on the shop
|-
|-
|}
|}

Latest revision as of 10:26, 18 June 2024

Funding information structure

This structure represents the details about the funding source of the last payment attempt. At the moment this is only used when the funding source is a bank card.

API usage

This structure is used by the following API endpoints:

Property list

Property name Property type Description
BankCard BankCard The bank card used to complete the payment. If there was no bank card used in the attempt, this is empty.
AuthorizationCode string The authorization code received by the card processing system when executing the payment. If authorization was not successful, this is empty.
ProcessResult string The result of the last card payment attempt (even if it was unsuccessful). If there was no charge attempt, this is empty.
Possible values:
  • Successful: the card transaction was successful
  • ProblemWithCard: the card transaction was unsuccessful: card number, CVC or/and expiry is wrong. The card may have been stolen, deleted, disabled or disabled for online transactions.
  • LowFunds: the card transaction was unsuccessful due to insufficient funds or limits were reached
  • LostOrStolenCard: the credit card has been reported lost or stolen
  • Declined: the payment card was declined by the acquirer
  • FraudulentTransaction: potentially fraudulent transaction, the monitoring system declined the transaction
  • CardSystemError: the card transaction failed due to the card system
  • ScaSoftDeclined: the payment card did not support SCA at the time of the transaction
  • FailedDuringAuthentication: there was an error during the SCA process thus authentication failed. This may not be returned if ChallengePreference was set to "NoChallengeNeeded"
  • CardNotSupported: the payment card is not supported at the time of the transaction
  • Unknown: the bank system did not provide information about the operation, the result of the process could not be determined
  • ThreeDsNotEnabled: Legacy error, not used any more. Could occur in case of older payments, where 3ds was not enabled on the shop