Create recurring transaction

This API call allows you to make a new payment by either committing an already authorized transaction or by making a recurring payment. The latter is only permitted if the following two conditions are met:

  • The cardholder has already been charged successfully in the past
  • The cardholder has agreed on allowing recurring payments on their card

Request information

POST /api/transactions/{TransactionId}

Authentication

This API call uses Identity Server authentication.

Parameters

Amount ( int64 ): The amount requested in cents (amount in euros x 100). For capturing authorized transactions, it should not exceed the amount entered in the original PreAuth. Note: If you want to create a payment for 100,37 €, you need to pass the value 10037

Installments ( int32 ): This Optional parameter defines the number of installments for the payment. Note: Acceptable values 1 to 36

Sample request

POST /api/transactions/252b950e-27f2-4300-ada1-4dedd7c17904

This is the ID of the original payment. You should use the same ID for every subsequent recurring transaction.

{
  "Installments": 0,
  "Amount": 500,
  "MerchantTrns": "Your Reference",
  "CustomerTrns": "Description for the customer receipt",
  "ActionUser": "user that initiated the call"
}

Response information

Method Output: TransactionResult object with the following documented attributes:

TimeStamp ( datetime ): The server date and time that the Payment Order creation was completed in ISO 8601 format.

TransactionId ( uuid ): The unique id for the new transaction.

StatusId ( string ): The current status of this transaction. It can have one of the following values:

StatusIdDescription
EThe transaction was not completed because of an error
AThe transaction is in progress
MThe cardholder has disputed the transaction with the issuing Bank
UA disputed transaction has been refunded
XThe transaction was cancelled by the merchant
RThe transaction has been fully or partially refunded
FThe transaction has been completed successfully

ErrorCode ( int32 ): If the call is not successful, an error code is generated. For successful calls the value 0 is returned.

ErrorText ( string ): If the ErrorCode is not 0, a descriptive error message is returned.

Sample response

{
  "TransactionId": "bd5390a9-5870-4d8d-abea-7f5a94f9cecc",
  "StatusId": "F",
  "ErrorCode": 0,
  "ErrorText": "Error Message",
  "TimeStamp": "2012-12-24T15:23:38.5157933+02:00"
}