Latest revision as of 08:38, 5 September 2017

Barion API: Storno/reverse a previously completed partner card topup

POST	/v2/Topup/StornoPartnerCardTopup

The /topup/stornopartnercardtopup API endpoint is used to reverse the transfer previously initiated by a topup via partner card.

Prerequisites before use:

v2 This API endpoint is available in API v2 only.

partners This API endpoint is available for trusted Barion partners only.

Property name	Property type	Limitations and constraints	Description
PartnerKey	Guid	Required	The secret API key of the trusted partner, generated by Barion.
TransactionId	Guid	Required	The identifier of the topup transaction

Property name	Property type	Description
IsSuccessful	bool	Indicates wether the storno process was successful
StornoTransactionId	Guid	The identifier of the resulting storno transaction

Error code	Description
NoIdentifiedPartnerFound	The given partner key was not valid
NotExistingTransactionId	The given topup transaction was not found in the database
SourceAccountNotAllowedForPartner	The originally specified source Barion wallet was not connected to the trusted partner
StornoTopupFailed	The topup process could not be completed due to an unknown error (contact the developer support)
MultipleStornoNotAllowed	The storno stransaction is illegeal because the original topup was already rolled back.

Request

{
    "PartnerKey": "3275b3c5-b6e4-4460-8b8d-a4bd20105511",
    "TransactionId": "1e995837-b22d-43cd-b4aa-47186cae457e"
}

Response

{
    "IsSuccessful": true,
    "StornoTransactionId": "dd340248-03ae-4883-a1b7-b0f268721e2e"
}

@@ Line 48: / Line 48: @@
 | NoIdentifiedPartnerFound || The given partner key was not valid
 |-
-| PartnerDataCannotBeRetrieved || The trusted partner data could not be retrieved (possibly has no rights for this endpoint)
+| NotExistingTransactionId || The given topup transaction was not found in the database
 |-
-| AuthenticationFailed || Authentication failed for the target organization (incorrect login name or password)
+| SourceAccountNotAllowedForPartner || The originally specified source Barion wallet was not connected to the trusted partner
 |-
-| RemoteRegisterInfoReturnedWithError || The company register service returned an error
+| StornoTopupFailed || The topup process could not be completed due to an unknown error (contact the developer support)
 |-
-| RegisterInfoCannotBeRetrievedFromDb || The company register record could not be retrieved from the Barion database. Please contact the Barion support.
+| MultipleStornoNotAllowed || The storno stransaction is illegeal because the original topup was already rolled back.
-|-
-| RegisterInfoCannotBeRetrievedFromRemote || The company register record could not be retrieved from the remote service. Possible causes:
-* The given company is not based in Hungary (there is no service to call)
-* The company register remote service is down
 |-
 |}
@@ Line 77: / Line 73: @@
 <syntaxhighlight lang="json">
 {
+    "IsSuccessful": true,
+    "StornoTransactionId": "dd340248-03ae-4883-a1b7-b0f268721e2e"
 }
 </syntaxhighlight>