---
title: "POST /v2/earn/payment-methods"
method: POST
path: "/v2/earn/payment-methods"
tags: ["Earn"]
---

# POST /v2/earn/payment-methods

`POST /v2/earn/payment-methods`

## Request body

- object
  - `metadata` object
  - `offchainId` string, required
  - `processorName` string, required
  - `spreadBps` integer

## Response `200`

Earn payment method added

- object
  - `success` boolean, required
  - `message` string, required
  - `responseObject` object
    - `depositId` string, required
    - `paymentMethod` string, required
    - `txHash` string, nullable, required
    - `whitelistEnrolled` boolean, required
  - `statusCode` number, required
  - `errorCode` string

## Other responses

- `202` — Earn payment method enrollment submitted but unconfirmed
- `400` — Earn payment method request invalid
- `409` — Earn deposit update conflict
- `502` — Earn payment method upstream failure

---

[API](https://skmtc.dev/peer/apis/swagger-api.md) · [All operations](https://skmtc.dev/peer/apis/swagger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/peer/swagger-api/revisions/d5fcf4abb61a/schema)