Payment method properties


Markets (consumer)	`US`
Processing currencies	`USD`
Consumer currencies	`USD`
Authentication methods	`REDIRECT`
Authentication timeout	15 minutes
Minimum payment amount	0.10 USD
Maximum payment amount	1,000 USD per transaction.
Payment medium	`ECOMMERCE`
Recurring payments	No
Separate captures	No
Refund	No
Disputes	No
Settlement risk	No

Make an Openbucks payment

Openbucks payments follow our standardized REDIRECT payment flow.

To create an Openbucks payment, you'll need to provide the following data at minimum when calling our payment charges endpoint:

Field	Description
`paymentMethod`	`OPENBUCKS`
`amount.value`	The amount to be paid, in the smallest unit of the currency used.
`amount.currency`	`USD`
`consumer.country`	`US`
authenticationSettings: REDIRECT `settings.returnUrl`	The URL to which the consumer should be redirected after completing the payment. Required for the `REDIRECT` flow.

Request

POST /v1/payment-charges

{
  "paymentMethod": "OPENBUCKS",
  "amount": {
    "value": 1000,
    "currency": "USD"
  },
  "consumer": {
    "country": "US",
    "email": "[email protected]"
  },
  "authenticationSettings": [
    {
      "type": "REDIRECT",
      "settings": {
        "returnUrl": "https://www.webshop.com/order-results-page"
      }
    }
  ]
}

Response

You'll receive our standard payment charge response with the available authentication methods.

{
  "id": "charge_Y3JVzvEaJpvG53xd2R2Zt",
  "paymentMethod": "OPENBUCKS",
  "paymentMedium": "ECOMMERCE",
  "scheduleType": "UNSCHEDULED",
  "instrumentId": "instr_Asu0ig2PXXZSiNrhY44A5",
  "currency": "USD",
  "country": "US",
  "status": "AUTHENTICATION_PENDING",
  "consumer": {
    "country": "US",
    "email": "[email protected]"
  },
  "authenticationMethods": [
    {
      "details": {
        "requestUrl": "https://redirection-target.ppro.com",
        "requestMethod": "GET"
      },
      "type": "REDIRECT"
    }
  ],
  "authorizations": [
    {
      "id": "authz_aPobet0FNZNU1bYqfexFd",
      "amount": 1000,
      "status": "AUTHENTICATION_PENDING",
      "createdAt": "2026-10-20T08:34:20.766Z",
      "updatedAt": "2026-10-20T08:34:20.766Z"
    }
  ],
  "captures": [],
  "refunds": [],
  "discards": [],
  "voids": [],
  "createdAt": "2026-10-20T08:34:20.114Z",
  "updatedAt": "2026-10-20T08:34:20.766Z"
}

Pick the desired authentication method

REDIRECT

Redirect your consumer to the returned $.authenticationMethods[?(@.type == "REDIRECT")].details.requestUrl

For example, with the value of https://redirect.ppro.com/ using the returned $.authenticationMethods[?(@.type == "REDIRECT")].details.requestMethod HTTP method.

REDIRECT

After the consumer completes the payment, they are redirected back to the returnUrl specified by you in the payment charge creation request.
Upon redirect back to your checkout page, retrieve the latest payment status by performing a GET operation on the payment charge, use the returned status attribute to determine the payment outcome and display it to the consumer.
Additionally, webhooks are triggered to notify you of the payment result. This ensures you receive the outcome even if the consumer closes their browser or fails to return to your website.

Sandbox testing

To request an Openbucks staging sandbox account, please contact your PPRO Account Manager.