Skip to main content

7-Eleven

Features
MethodOver the counter, Async - POST Redirect
CountriesMalaysia
Processing currenciesMYR
Increments-
Captures-
Partial/Multiple partial captures-
Cancels-
Partial/Multiple partial cancels-
Refunds-
Partial/Multiple partial refunds-
Recurring-
Installments-
Credits-
Disputes-
Min Amount1.01
Account verification-

It is an over the counter payment method that is initiated in an e-commerce environment but completed by paying in cash at a 7-Eleven retail location.

An over the counter (OTC) payment is a payment method where consumers deposit money in-person at a retail location, such as 7-Eleven, Ever Superstores, Gaisano, and Cebuana among others, to pay for items purchased online.

When a consumer shops online using the 7-Eleven payment method, the merchant sends a payment to the PSP.

The consumer email has to be provided in the request and it will trigger a notification to the consumer by email with the 7-Eleven reference.

The merchant redirects to the 7-Eleven page and shows the 7-Eleven reference. The consumer can now go back to the ReturnUrl.

Now the consumer can complete the purchase in-person at a 7-Eleven store with cash using the 7-Eleven reference.

Payment flow

7-Eleven payment flow

Required constraints

  • Webhooks or polling mechanisms are mandatory as the payment is completed in a 7-Eleven store.
  • The consumer mail is required in order to receive the reference number from 7-Eleven, although the consumer can get the 7-Eleven reference number from the screen too.

Payment

Request

{
"processingAccountId": "2HdN2jq6XWmlkhqRC2gDTNYCvNH",
"merchantReference": "B2A8734D-9450-4915-A63D-FE5C21F09550",
"amount": {
"value": 200,
"currency": "myr"
},
"paymentMethod": {
"type": "seven_eleven",
"sevenEleven": {
"returnUrl": "https://merchant.site/complete-payment",
"consumer": {
"email": "consumer@mail.com"
}
}
}
}

Response

{
"id": "27yiW9MgzBtwiodreuNOXk0rtIw",
"merchantReference": "B2A8734D-9450-4915-A63D-FE5C21F09550",
"status": "pending",
"trackingUrl": "/v1/tracks/payments/{trackId}",
"reason": {
"code": "required_next_step",
"description": "An additional step is needed to complete the payment."
},
"nextStep": {
"type": "redirect",
"redirect": {
"method": "post",
"url": "https://payment.method/complete",
"params": [
{
"name": "param1",
"value": "value1"
},
{
"name": "param2",
"value": "value2"
}
]
}
}
}