Skip to main content

Customer-present payments

When using the ePayment API to process payments in a physical setting (e.g., from a Point of Sale device or in a restaurant), the POST:/epayment/v1//payments request must specify "customerInteraction": "CUSTOMER_PRESENT".

The CUSTOMER_PRESENT parameter is required for compliance and reporting reasons, as the risk is lower when the customer is physically present than when the customer is paying remotely over the net.

Example request:

curl -X POST https://apitest.vipps.no/epayment/v1/payments \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR-ACCESS-TOKEN" \
-H "Ocp-Apim-Subscription-Key: YOUR-SUBSCRIPTION-KEY" \
-H "Merchant-Serial-Number: YOUR-MSN" \
-H 'Idempotency-Key: YOUR-IDEMPOTENCY-KEY' \
-H "Vipps-System-Name: acme" \
-H "Vipps-System-Version: 3.1.2" \
-H "Vipps-System-Plugin-Name: acme-webshop" \
-H "Vipps-System-Plugin-Version: 4.5.6" \
-d '{
"amount": {
"currency": "NOK",
"value": 49900
},
"paymentMethod": {
"type": "CARD"
},
"customerInteraction": "CUSTOMER_PRESENT",
"reference": "acme-shop-123-order123abc",
"returnUrl": "https://example.com/redirect?reference=acme-shop-123-order123abc",
"userFlow": "WEB_REDIRECT",
"paymentDescription": "Two pairs of socks"
}'

Help us improve our documentation

Did you find what you were looking for?