curl --request POST \
  --url https://sandbox.elementpay.net/api/v1/partner/orders/{quote_id}/accept \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{}'

{
  "status": "success",
  "message": "Partner order quote accepted",
  "data": {
    "quote_id": "yc_receive_580e04c2-a136-5cca-be54-b49fcf80970c",
    "status": "processing",
    "order": {
      "order_id": "YC-580e04c2-a136-5cca-be54-b49fcf80970c",
      "status": "processing",
      "order_type": "OnRamp",
      "amount_fiat": 800,
      "amount_crypto": 5.94999,
      "currency": "KES",
      "token": "BASE_USDC",
      "wallet_address": "0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe",
      "exchange_rate": 131.69,
      "psp_transaction_id": "580e04c2-a136-5cca-be54-b49fcf80970c"
    },
    "accepted": {
      "payment_instructions": {
        "type": "momo",
        "source": {
          "accountNumber": "+2541111111111",
          "networkName": "Mobile Wallet (M-PESA)"
        }
      }
    },
    "webhooks": {
      "events": [
        "order.processing",
        "order.settled",
        "order.failed",
        "order.refunded"
      ],
      "delivery": "ElementPay will notify the webhook_url configured on the API key."
    },
    "rail": "local_fiat"
  }
}

{
  "status": "error",
  "message": "Unsupported quote_id. Expected `yc_receive_<preview_id>` or `yc_send_<preview_id>`."
}

{
  "status": "error",
  "message": "Quote request failed",
  "data": null
}

{
  "status": "error",
  "message": "Missing requirements for selected route",
  "data": {
    "field": "order_type"
  }
}

{
  "status": "error",
  "message": "Quote request failed",
  "data": null
}

Partner

Accept a partner order quote

Accepts a quote returned by /partner/orders/quote. For local fiat rail, the quote_id already contains the provider and direction, so the request body can be {}. international bank quote ids work the same way. Accepting creates or returns the local ElementPay order, copies the API key webhook URL, and triggers partner webhook notifications as the order moves through order.processing, order.settled, order.failed, or order.refunded. This route is idempotent for already accepted local fiat rail previews: retries return the existing local order.

POST

partner

orders

{quote_id}

curl --request POST \
  --url https://sandbox.elementpay.net/api/v1/partner/orders/{quote_id}/accept \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{}'

{
  "status": "success",
  "message": "Partner order quote accepted",
  "data": {
    "quote_id": "yc_receive_580e04c2-a136-5cca-be54-b49fcf80970c",
    "status": "processing",
    "order": {
      "order_id": "YC-580e04c2-a136-5cca-be54-b49fcf80970c",
      "status": "processing",
      "order_type": "OnRamp",
      "amount_fiat": 800,
      "amount_crypto": 5.94999,
      "currency": "KES",
      "token": "BASE_USDC",
      "wallet_address": "0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe",
      "exchange_rate": 131.69,
      "psp_transaction_id": "580e04c2-a136-5cca-be54-b49fcf80970c"
    },
    "accepted": {
      "payment_instructions": {
        "type": "momo",
        "source": {
          "accountNumber": "+2541111111111",
          "networkName": "Mobile Wallet (M-PESA)"
        }
      }
    },
    "webhooks": {
      "events": [
        "order.processing",
        "order.settled",
        "order.failed",
        "order.refunded"
      ],
      "delivery": "ElementPay will notify the webhook_url configured on the API key."
    },
    "rail": "local_fiat"
  }
}

{
  "status": "error",
  "message": "Unsupported quote_id. Expected `yc_receive_<preview_id>` or `yc_send_<preview_id>`."
}

{
  "status": "error",
  "message": "Quote request failed",
  "data": null
}

{
  "status": "error",
  "message": "Missing requirements for selected route",
  "data": {
    "field": "order_type"
  }
}

{
  "status": "error",
  "message": "Quote request failed",
  "data": null
}

Accept a previously created quote and create the local order. Send the same customer and payment method payload shape used at quote time (see Test payloads). OnRamp: final payment instructions are returned after accept when applicable.

Authorizations

X-API-Key

string

header

required

Path Parameters

quote_id

string

required

Quote id returned by /partner/orders/quote.

Body

application/json

Accept a partner quote. Empty body is supported when quote_id identifies the route.

provider

enum<string> | null

Optional provider assertion. Usually inferred from quote_id.

Available options:

local fiat rail,

international bank,

elementpay

payment_method

Payment Method · object | null

Required for international bank OffRamp: form fields from the corridor's form_schema (returned in the quote response). Keys match the international bank FormSchema properties e.g. BankDetails, AccountHolderName, PaymentPurpose.

Response

Partner order quote accepted