3.38. 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 pay.billblend.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 pay.billblend.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