Create payment methods

Beta

POST

/v2/payment-methods

POST

/api/v2/payment-methods

curl -X POST https://api-sandbox.payabli.com/api/v2/payment-methods \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "data": [
    {
      "type": "bank_account",
      "accountOwner": "019fed1a-3d6e-75d3-a81e-cba3874b0a55",
      "ownerType": "business",
      "accountType": "checking",
      "accountNumber": "123456789",
      "routingNumber": "021000021",
      "usage": [
        "deposits",
        "billing"
      ],
      "nickname": "Operating account",
      "financialInstitution": "Bank of Example"
    }
  ]
}'

{
  "success": true,
  "message": "Payment method created successfully",
  "traceId": "0HNNN6HH5NE18:00000010",
  "data": [
    {
      "paymentMethodReference": "019ff142-454b-7721-96a3-c8628b9d568f",
      "type": "bank_account",
      "accountOwner": "019fed1a-3d6e-75d3-a81e-cba3874b0a55",
      "ownerType": "business",
      "status": "PENDING",
      "createdAt": "2026-08-11T14:38:00.0117762Z",
      "lastUpdated": "2026-08-11T14:38:00.0117763Z",
      "_links": {
        "self": "/api/v2/payment-methods/019ff142-454b-7721-96a3-c8628b9d568f",
        "owner": "/api/v2/businesses/019fed1a-3d6e-75d3-a81e-cba3874b0a55"
      },
      "fingerprint": "2a0c2a64d03492ba45af4d01f329f22b41513411cab7658072739d17ed570675",
      "tokenReference": "deacc32d-81eb-470b-9cff-0ad2fab87096",
      "nickname": "Operating account",
      "financialInstitution": "Bank of Example",
      "accountType": "Checking",
      "accountNumber": "****6789",
      "routingNumber": "*****0021",
      "usage": [
        "deposits",
        "billing"
      ]
    }
  ]
}

Creates one or more payment methods for an entity in a single call. Set each payment method’s accountOwner to the entity it belongs to.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

datalist of objectsRequired

The payment methods to create.

Response

Payment methods created.

successboolean

Whether the request succeeded.

messagestring or null

A human-readable result message.

traceIdstring or null

The trace identifier for the request, useful for support.

datalist of objects or null

The created payment methods, in the order they were sent.

Errors

400

Bad Request Error

401

Unauthorized Error

409

Conflict Error

500

Internal Server Error