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