Taxi payments

Scenario 1: Payment through taximeter

The customer orders a taxi in the taxi company's app. After the journey, the taximeter automatically initiates a payment request to Vipps or MobilePay with the customer's phone number, which is already known. The customer's Vipps or MobilePay app opens, and the customer pays the amount due.

Steps:

1. Customer's phone number is entered into the taximeter.
2. Merchant system sends a payment request.
3. Customer authorizes the payment in Vipps/MobilePay.
4. Merchant system captures the payment.

Details for taxi payment through taximeter

Use userFlow:PUSH_MESSAGE and "customerInteraction": "CUSTOMER_PRESENT" while initiating the payment. You need the customer's phone number to send them a request from the taximeter. You may also attach the order details at this time.

Payment through taximeter flow

Scenario 2: Payment through company website

The customer scans a QR code that directs them to the taxi company's landing page. The company sends a payment request to them through the Vipps or MobilePay app.

Steps:

1. Customer scans the QR with their phone to come to the company website.
2. Merchant system sends a payment request.
3. Customer authorizes the payment in Vipps/MobilePay.
4. Merchant system captures the payment.

Details for taxi payment through company website

Use userFlow:PUSH_MESSAGE and "customerInteraction": "CUSTOMER_PRESENT" while initiating the payment. You need the customer's phone number to send them a request from the taximeter.

Payment through company website

Scenario 3: Payment through company app

The customer pays the taxi company from their app when ordering the taxi and selects to pay with Vipps MobilePay. The amount is reserved until the final amount is known, at which time the payment is captured.

Steps:

1. Customer is logged into the company app.
2. Customer orders a taxi and selects Vipps/MobilePay as payment method.
3. Merchant system sends a payment request for the estimated amount.
4. Customer authorizes the payment in Vipps/MobilePay.
5. The journey takes place and the true price of the journey is calculated.
6. Merchant system does a partial capture - capturing only the true value of the journey (not exceeding the original estimated amount).
7. Merchant system cancels the remaining amount.
8. (Optional and recommended) Merchant system attaches order details showing amount paid.

Details for taxi payment through company app

Since the customer is selecting this from an app on their phone, you don't need their phone number. This payment command can do an app-switch and open their app with the payment request. Specify "userFlow": "WEB_REDIRECT" to redirect user to the app. Specify "customerInteraction": "CUSTOMER_PRESENT".

Payment through company app flow

Related pages

When you are ready to learn about the technical details, review related sections:

• ePayment API guide
• Order Management API guide
• Merchant Redirect QR codes