Get capital advance offers

Overview

Get capital advance offers is used to retrieve the available capital advance offers associated with an account_id. Implement the call with a valid OAuth2 bearer token; confirm paths and fields in the API reference.

Get offers (API)

Call the Get Capital Advance offers endpoint for the user's account to retrieve available offers. Example (sandbox):

curl -X GET \
https://api.sandbox.payoneer.com/v4/accounts/{account_id}/capital-advance/offers \
-H "Authorization: Bearer MXVNd2NTcTBlTi94NkZC…" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Replace {account_id} and the bearer token with values for your integration.

Example response

Example JSON shape; field names and nesting may match your program's current API version.

{
  "result": {
    "offers": {
      "items": [
        {
          "id": 30985,
          "type": "grow",
          "status": "new",
          "marketplace_name": "Amazon US",
          "store_name": "Store_87",
          "amount": 50.0,
          "currency": "USD",
          "fee": {
            "amount": 1.5,
            "percentage": 3.0
          },
          "valid_until": "2020-12-29T23:59:59",
          "invitation_date": "2020-12-22T07:38:52.813",
          "settlement_plan": {
            "estimated_settlement_date": "2020-12-24T00:00:00-05:00",
            "collection_percentage": 35.0
          },
          "url": "https://myaccount.sandbox.payoneer.com/?action=earlypayments"
        }
      ],
      "total": 10
    }
  }
}

Present offers on your platform

On your platform, present the customer with the capital advance offers and the URL from each item (for example the url field) to claim the offer, subject to your UX and program rules.

UI reference

Example of how offer data (marketplace, store, amount, fee, settlement plan, and related fields) can be reflected in a partner dashboard under Payment Options > Payoneer > Capital Advance — Offers / Tracking. Field mapping depends on your UI product.

Example layout: list offers, accept actions, and offer details (data maps from API response fields such as store name, amount, fee, and settlement plan).