REFUND request

post https://simpleapitest.ppro.com/.

The interface for refunds enables you to refund an existing, successful transaction for which funds have been received. Depending on the contract and payment method used in the original transaction (multiple) partial refunds might be possible as well.

Input parameters for the REFUND call:

Form Data

returnmode

string

required

Defaults to urlencodeext

Must always be set to urlencodeext.

txtype

string

required

Defaults to REFUND

The transaction type.

string

required

Defaults to testclient

The PPRO-provided login.

password

string

required

Defaults to test123

The PPRO-provided password.

contractid

string

required

Defaults to TESTCONTRACT

Defines the merchant for whom PPRO is processing the transaction.

reftxid

string

required

Defaults to 123887123

The Payment Gateway transaction id of the transaction to refund (referenced transaction id).

currency

string

required

Defaults to EUR

The 3-letter ISO currency code (e.g. EUR). Must match the currency of the original transaction.

amount

int32

required

Defaults to 1700

The amount to refund in the currency’s smallest representable unit as per ISO4217.
Example:
For 1 JPY, the amount is 1.
For 1 IDR, the amount is 100.

merchantrefundid

string

Defaults to MS123R

Your refund identifier.
Allowed characters: [a-zA-Z0-9.,-_].
Maximum of 40 characters. Uniqueness is not enforced and is the client’s responsibility in the context of a contract.

xxxxxxxxxx
curl --request POST \
     --url https://simpleapitest.ppro.com/. \
     --header 'content-type: application/x-www-form-urlencoded' \
     --data returnmode=urlencodeext \
     --data txtype=REFUND \
     --data login=testclient \
     --data password=test123 \
     --data contractid=TESTCONTRACT \
     --data reftxid=123887123 \
     --data currency=EUR \
     --data amount=1700 \
     --data merchantrefundid=MS123R