NodeRings Docs

Attach Payment Method

Attach a payment method to a subscription/organization Works for both providers (platform subscriptions) and clients (provider plan subscriptions) Authorization: Check organization type and rule engine (subscription.payment_method.manage.enabled)

POST
/v1/payment-methods
Authorization<token>

Bearer token

In: header

X-Organization-ID<token>

Tenant or organization identifier

In: header

subscriptionId?string
paymentMethodId?string

Optional: Payment method ID (if using existing)

paymentMethodToken?string
setAsDefault?boolean

Whether to set as default payment method

metadata?object

Optional: custom metadata

Response Body

application/json

curl -X POST "https://api.nrings.io/v1/payment-methods" \  -H "Authorization: Bearer {your_token}" \  -H "X-Organization-ID: {your_org_id}" \  -H "Content-Type: application/json" \  -d '{  "subscriptionId": "string",  "paymentMethodId": "string",  "paymentMethodToken": "string",  "setAsDefault": false,  "metadata": null}'
{
  "paymentMethod": {
    "id": "string",
    "customerId": "string",
    "paymentProviderPaymentMethodId": "string",
    "type": "string",
    "last4": "string",
    "brand": "string",
    "expiryMonth": 0,
    "expiryYear": 0,
    "isDefault": true,
    "metadata": {},
    "createdAt": "2019-08-24T14:15:22Z",
    "organizationId": "string",
    "subscriptionId": "string",
    "status": "STATUS_UNSPECIFIED",
    "timestamps": {
      "createTime": "2019-08-24T14:15:22Z",
      "updateTime": "2019-08-24T14:15:22Z"
    }
  }
}