> This page is for Afterpay Partner API.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.afterpay.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.afterpay.com/_mcp/server.

### Schema (`response`)

```yaml
openapi: 3.1.0
info:
  title: API
  version: 1.0.0
paths:
  /buy-rates-schema:
    get:
      operationId: subpackageRates_getBuyRatesSchema
      summary: BuyRates Schema
      tags:
        - subpackage_rates
      responses:
        '200':
          description: BuyRates schema
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Rates_getBuyRatesSchema_Response_200'
tags:
  - name: subpackage_rates
servers:
  - url: https://agencyapi.afterpay.com
    description: Production
  - url: https://agencyapi.sandbox.afterpay.com
    description: Sandbox
components:
  schemas:
    BaseRateRateType:
      type: string
      enum:
        - INTRODUCTORY
        - ONGOING
      description: >-
        Type of rate whether introductory for temporary promotional periods or
        ongoing for steady-state business.
      title: BaseRateRateType
    BaseRate:
      type: object
      properties:
        variableRatePercentage:
          type: string
          description: Variable part of the buy-rate in percentage format e.g. 5.00 for 5%.
        fixedRate:
          type: string
          description: Fixed part of the buy-rate e.g. 0.30 for 30 cents.
        fixedRateCurrencyCode:
          type: string
          description: >-
            Currency of the fixed part of the buy-rate in the three-letter ISO
            4217 currency code.
        rateType:
          $ref: '#/components/schemas/BaseRateRateType'
          description: >-
            Type of rate whether introductory for temporary promotional periods
            or ongoing for steady-state business.
        durationInMonths:
          type: integer
          description: Number of months that the introductory rate will be applied.
      required:
        - variableRatePercentage
        - fixedRate
        - fixedRateCurrencyCode
        - rateType
      title: BaseRate
    BuyRatesTierDetailsItems:
      type: object
      properties:
        tier:
          type: integer
          description: Volume-based tier that was defined during commercial discussions.
        minimumGmv:
          type: string
          description: Lower bound of the tier.
        maximumGmv:
          type: string
          description: Higher bound of the tier.
        GmvCurrencyCode:
          type: string
          description: Currency of the GMV tier.
        tieredRates:
          type: array
          items:
            $ref: '#/components/schemas/BaseRate'
      required:
        - tier
        - minimumGmv
        - maximumGmv
        - GmvCurrencyCode
        - tieredRates
      title: BuyRatesTierDetailsItems
    BuyRates:
      type: object
      properties:
        defaultRates:
          $ref: '#/components/schemas/BaseRate'
        tierDetails:
          type: array
          items:
            $ref: '#/components/schemas/BuyRatesTierDetailsItems'
          description: Volume-based tiers and rates object.
      required:
        - defaultRates
        - tierDetails
      title: BuyRates
    Rates_getBuyRatesSchema_Response_200:
      type: object
      properties:
        buy_rates:
          $ref: '#/components/schemas/BuyRates'
      required:
        - buy_rates
      title: Rates_getBuyRatesSchema_Response_200

```

**`Example`**

```json Example
{
  "defaultRates": {
    "variableRatePercentage": "5.00",
    "fixedRate": "0.30",
    "fixedRateCurrencyCode": "USD",
    "rateType": "INTRODUCTORY",
    "durationInMonths": 3
  },
  "tierDetails": [
    {
      "tier": 1,
      "minimumGmv": "0",
      "maximumGmv": "1000000",
      "GmvCurrencyCode": "USD",
      "tieredRates": [
        {
          "variableRatePercentage": "3.5",
          "fixedRate": "0.3",
          "fixedRateCurrencyCode": "USD",
          "rateType": "ONGOING"
        }
      ]
    }
  ]
}
```