Payment-Refund-v2: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
|||
Line 59: | Line 59: | ||
| RefundedTransactions || [[RefundedTransaction]][] || An array containing information about the refunded transactions. | | RefundedTransactions || [[RefundedTransaction]][] || An array containing information about the refunded transactions. | ||
|} | |||
== Possible error responses == | |||
{| class="wikitable api-table" | |||
! Error code || Description | |||
|- | |||
| ModelValidationError || This happens when some of the input properties fail the basic validation. For example a string property exceeds its allowed length. | |||
|- | |||
|} | |} |
Revision as of 16:37, 21 January 2020
Barion API: Execute the refund of a payment
POST | /v2/Payment/Refund |
---|
The /payment/refund
API endpoint is used to execute a refund of an existing, completed payment.
Prerequisites before use:
- Creating an account in Barion
- Creating a shop in Barion
- Calling the Barion API
- API: /Payment/Start
- API: /Payment/GetPaymentState
v2 This API endpoint is available in API v2 only.
Use cases
This API endpoint is designed to be used in the following scenarios:
Input properties
Property name | Property type | Limitations and constraints | Description |
---|---|---|---|
POSKey | Guid |
|
The secret API key of the shop, generated by Barion. This lets the shop to authenticate through the Barion API, but does not provide access to the account owning the shop itself. |
PaymentId | Guid |
|
The identifier of the payment in the Barion system. |
TransactionsToRefund | TransactionToRefund[] |
|
An array containing the payment transactions to refund. |
Output properties
Property name | Property type | Description |
---|---|---|
PaymentId | Guid | The identifier of the payment in the Barion system. |
RefundedTransactions | RefundedTransaction[] | An array containing information about the refunded transactions. |
Possible error responses
Error code | Description |
---|---|
ModelValidationError | This happens when some of the input properties fail the basic validation. For example a string property exceeds its allowed length. |