Add or Update Default Funding Method

🚧

Availability Notice:

This API will be available starting November 26, 2025. Requests before that date may be rejected.

Endpoint:
POST https://sandbox-api.veem.com/veem/v1.2/funding-methods/account/{accountId}/default

Description

Creates or updates the default funding methods (credit and/or debit) for the authenticated account.

If a funding method is provided, the API validates that:

• The funding method exists for the account.
• The ID and type match the existing record.
• The funding method status is Active.
• If credit, the funding method must be valid to receive funds.
• If debit or billing, the funding method must be valid to send funds.

If all validations pass, the preference is saved for the account.

Headers

Request Param

Request Body

Example Request

{
  "defaultCreditMethod": {
    "id": 123456,
    "type": "Card"
  },
  "defaultDebitMethod": {
    "id": 123789,
    "type": "Bank"
  },
  "defaultBillingMethod": {
    "id": 456789,
    "type": "VirtualBank"
  }
}

Responses

✅ 200 OK Returns the created or updated funding method preference.

{
	"accountId": 123741,
  "defaultCreditMethod": {
    "id": 123456,
    "type": "Card"
  },
  "defaultDebitMethod": {
    "id": 123789,
    "type": "Bank"
  },
  "defaultBillingMethod": {
    "id": 456789,
    "type": "VirtualBank"
  }
}

Error Responses

Example Validation Error

{
  "errorCode": "INVALID_FUNDING_METHOD",
  "message": "defaultDebitMethod (id 54848) is not Active; status=Inactive"
}

Notes

• You can send either defaultCreditMethod, defaultDebitMethod, or both.
• Validation is performed independently for each provided method.
• The funding method must belong to the authenticated account.
• The operation is idempotent — resubmitting the same data will not create duplicates.
• If no changes are detected, the API will return the existing preference.

Example cURL

curl -X POST "https://sandbox-api.veem.com/veem/v1.2/funding-methods/account/:accountId/default" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Request-Id: 123e4567-e89b-12d3-a456-426614174000" \
  -H "Content-Type: application/json" \
  -d '{
        "defaultCreditMethod": {
          "id": 54864,
          "type": "Card"
        },
        "defaultDebitMethod": {
          "id": 54848,
          "type": "Card"
        },
        "defaultBillingMethod": {
          "id": 456789,
          "type": "VirtualBank"
        }
      }'