3.42. Final Redirect

Final Redirect Parameters

Final redirect to merchant (represented by Connecting Party) website is performed when Payer ends payment flow. Final redirect is initiated from within Payer’s browser using HTTP POST method.

Redirect parameter name

Description

status

See Status List for details.

orderid

Order id assigned to the order by gate.connpay.com.

merchant_order

Connecting Party order id.

client_orderid

Connecting Party order id.

error_message

If status is declined or error this parameter contains the reason for decline or error details.

control

Checksum used to ensure that it is gate.connpay.com (and not a fraudster) that initiates the request. This is SHA-1 checksum of the concatenation status + orderid + client_orderid + merchant-control.

descriptor

Gate descriptor.

processor-tx-id

Acquirer transaction identifier.

amount

Actual transaction amount.

bin

Bank BIN of customer credit card number.

type

The type of response.

card-type

Type of customer credit card.

phone

Customer phone.

last-four-digits

Last four digits of customer credit card number.

card-holder-name

Cardholder name.

error_code

Error Code.

Connecting Party should not use Payer redirect as a main source of information about transaction’s final status. If Connecting Party has passed server_callback_url in initial transaction request, Payment Gateway will call this URL. Connecting Party may use it for custom processing of the transaction completion, e.g. to collect sales data in Connecting Party database. The parameters sent to this URL are specified in Connecting Party Callbacks.

Final Redirect Request Example

Payment Gateway sends POST redirect to https://connectingparty.com/pay/redirect?token=some_token with params in x-www-form-urlencoded format:

error_message=null
&processor-tx-id=PNTEST-1788082
&amount=100.00
&merchant_order=test
&orderid=1788082
&client_orderid=test
&bin=444455
&control=854f38715ee6bf43fa18e3ca202985a06e0ae755
&gate-partial-reversal=enabled
&descriptor=DEMO1
&gate-partial-capture=enabled
&type=sale
&card-type=VISA
&phone=%2B31201112233
&last-four-digits=1111
&card-holder-name=TEST+HOLDER
&status=approved