You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/subscriptions/one-off-payments.md
+3-27
Original file line number
Diff line number
Diff line change
@@ -4,12 +4,11 @@ sidebar_position: 6
4
4
5
5
# One-off Payments
6
6
7
-
There are 3 flows a customer can pay for a product or a service with One-Off payments.
7
+
There are 2 flows a customer can pay for a product or a service with One-Off payments.
8
8
You are able to:
9
9
10
10
*[Flow 1](#flow-1--one-off-payment-with-a-new-agreement): Create a new Agreement with an initial One-Off Payment.
11
-
*[Flow 2](#flow-2---one-off-payment-on-an-existing-agreement): Customer can initiate and request arbitrary One-Off Payment payments on their existing Agreement.
12
-
*[Flow 3](#flow-3---one-off-with-auto-reserve): Merchants can send a One-Off payment, which MobilePay will attempt to automatically reserve, without the user’s confirmation
11
+
*[Flow 2](#flow-2---one-off-with-auto-reserve): Merchants can send a One-Off payment, which MobilePay will attempt to automatically reserve, without the user’s confirmation
13
12
14
13
Note: One-off payments are charged when the customer manually swipes accept or `auto_reserve` field was set to **true** when a one-off payment was requested.
15
14
@@ -93,32 +92,9 @@ In this case, the response of `POST /api/providers/{providerId}/agreements` will
93
92
}
94
93
```
95
94
96
-
## Flow 2 - One-off Payment on an Existing Agreement
97
95
98
-
Use a `POST /api/providers/{providerId}/agreements/{agreementId}/oneoffpayments` endpoint in order to charge your customer one time for extra services.
99
96
100
-
* Use case: When the customer already has an active agreement and wants to order extra services/products. It is customer-initiated, and the customer needs to swipe in the MobilePay app. It is not possible to capture expired payments.
101
-
* Capture and Reserve is handled by the Merchant. The Merchant needs to capture the payment, to avoid that the payment will end up as being expired. It is dependent on the merchant's use case, and how fast the Merchant wants to capture the One-Off payment. For example, a hotel may reserve a payment, then move the money when the guest checks out.
102
-
* Merchant uses Agreement ID to make the payment request, not the phone number.
103
-
104
-
The response of `POST /api/providers/{providerId}/agreements/{agreementId}/oneoffpayments` contains two values: a unique *id* of the newly requested **One-Off Payment** and a link *rel* = *mobile-pay*.
* The *id* value can be used on the merchant's back-end system to map a one-off payment with a specific Subscription agreement on the merchant's side, and subsequently to capture a requested **One-Off Payment** when the MobilePay user accepts it.
119
-
* The link *rel = mobile-pay* hyperlink reference must be used to redirect the user automatically using an HTTP response 302 or 303. Once the user is redirected, the MobilePay app will be opened to confirm the **One-off Payment**. This applies only if the `auto_reserve` field is omitted or set to **false**.
120
-
121
-
## Flow 3 - One-off with Auto reserve
97
+
## Flow 2 - One-off with Auto reserve
122
98
123
99
* The one-off payment without swipe is sent directly to the MobilePay app. There is no MobilePay landing page. If the payment is successful, then a push message is shown that the One-off without swipe/confirmation was successful.
124
100
* One-Off without swipe is valid for One-Offs without a new agreement.
0 commit comments