Create purchase attempt.

​

Creates a purchase attempt and returns a redirect URL for Paypercut-hosted BNPL checkout. Redirect the customer to redirect_url to continue.

Body·
required
application/json
  • application_id
    Type: string · application id if not provided, it will be use the first application in the list
  • merchant_purchase_ref
    Type: string · identification of a unique purchase within the merchant system You can not have multiple attempts with the same merchant_purchase_ref
  • customer_redirect
    Type: object ·
  • purchase_details
    Type: object ·
  • transaction_flow_config
    Type: object ·
  • locale
    Type: string

    Preferred locale for the Paypercut-hosted purchase pages (e.g. bg-BG, en-GB). Omit to use the default for your integration's country: BG → bg-BG, SK → sk-SK, otherwise en-GB. Set explicitly when the buyer's language should override the default.

  • product_lane
    Type: string

    Product lane chosen at checkout: installments (default) or loan.

Responses
  • application/json
  • application/json
Request Example for post/v1/bnpl/attempt
curl /v1/bnpl/attempt \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "application_id": "",
  "merchant_purchase_ref": "",
  "customer_redirect": {
    "approved_url": "",
    "canceled_url": ""
  },
  "purchase_details": {
    "billing_address": {
      "person": {
        "first_name": "",
        "last_name": "",
        "other_names": "",
        "phone": "",
        "email": "",
        "national_id": "",
        "date_of_birth": {
          "year": 1,
          "month": 1,
          "day": 1
        }
      },
      "address": {
        "country_code": "",
        "city": "",
        "postal_code": "",
        "street1": "",
        "street2": "",
        "country_region": "",
        "district": "",
        "block": "",
        "entrance": "",
        "floor": "",
        "apartment": "",
        "state": ""
      },
      "company": {
        "name": "",
        "vat_id": "",
        "trading_name": "",
        "registration_number": "",
        "incorporation_country_code": "",
        "email": "",
        "phone": "",
        "website": "",
        "contact_first_name": "",
        "contact_last_name": ""
      }
    },
    "shipping_address": {
      "person": {
        "first_name": "",
        "last_name": "",
        "other_names": "",
        "phone": "",
        "email": "",
        "national_id": "",
        "date_of_birth": {
          "year": 1,
          "month": 1,
          "day": 1
        }
      },
      "address": {
        "country_code": "",
        "city": "",
        "postal_code": "",
        "street1": "",
        "street2": "",
        "country_region": "",
        "district": "",
        "block": "",
        "entrance": "",
        "floor": "",
        "apartment": "",
        "state": ""
      },
      "company": {
        "name": "",
        "vat_id": "",
        "trading_name": "",
        "registration_number": "",
        "incorporation_country_code": "",
        "email": "",
        "phone": "",
        "website": "",
        "contact_first_name": "",
        "contact_last_name": ""
      }
    },
    "customer": {
      "customer_ref": ""
    },
    "shopping_card": {
      "currency_code": "",
      "shipping_amount": "",
      "tax_amount": "",
      "total_amount": "",
      "discount_amount": "",
      "items": [
        {
          "title": "",
          "image_url": "",
          "item_url": "",
          "sku": "",
          "item_version": "",
          "qty": "",
          "unit_price": ""
        }
      ]
    }
  },
  "transaction_flow_config": {
    "transaction_capture": "TRANSACTION_CAPTURE_UNSPECIFIED"
  },
  "locale": "",
  "product_lane": ""
}'

{
  "attempt_id": "string",
  "redirect_url": "string",
  "expiration_time": "2026-07-22T07:07:22.947Z"
}

A successful response.