Skip to main content
POST /v1/payments/retailPay Initiates a retail payment where the merchant scans the customer’s wallet QR code or barcode (Customer Presented Mode). Rebell generates the payment QR code/barcode in the user’s Rebell app; after the merchant scans it with a code-scanning device, the payment completes automatically.

Request Parameters

string
required
Fixed product code for B Scan C: 51051000101000100040Max length: 32 characters
string
required
Merchant-generated unique identifier (idempotency key). Must be unique per transaction.Max length: 64 characters
string
required
The QR code or barcode content scanned from the customer’s wallet, generated by the wallet platform. Required in the retail pay scenario. One paymentAuthCode can be used for only one retail pay order. Example: 281013042025061007121301581456134Max length: 128 characters
object
required
Payment amount. See Amount. Example: {"currency": "EUR", "value": "20000"}
object
required
Order details.
string
Payment result notification URL. When the payment succeeds or the order is closed, Rebell notifies the result to this URL (see notifyPayment). Whether a notification is sent depends on the merchant’s contract. Example: https://merchant.example.com/paymentResultMax length: 1024 characters
string
JSON-formatted extension data. Supported keys:
  • channelSource: INSTORE
  • miniAppId
  • miniAppName
  • miniAppLogo
Example: "{\"channelSource\":\"INSTORE\",\"miniAppId\":\"12312312312\"}"Max length: 2048 characters

Response Parameters

object
required
Standard result object with resultCode, resultStatus, resultMessage
string
Echo of the merchant-provided request identifier.
string
Wallet-generated unique payment identifier.Max length: 64 characters
string
Payment completion time in ISO 8601 format.
object
Confirmed payment amount.

Result Codes

Sample

Request

Response