---
title: "Create a new walletLink"
method: POST
path: "/v1/paymaya/wallet_links"
tags: ["PayMaya"]
---

# Create a new walletLink

`POST /v1/paymaya/wallet_links`

## Request

- Base URL: `https://ewallets-api.paymongo.com`
- URL: `https://ewallets-api.paymongo.com/v1/paymaya/wallet_links`
- Auth: HTTP basic

Creates a walletLink for subscription payments

## Request body

- CreateWalletLinkRequestDTO: Request payload for creating a new binding with custom parameters
  - `merchant_redirect_url` MerchantRedirectUrl, required
    - `cancel` string
    - `failure` string
    - `success` string
  - `organization_id` string, required
  - `payment_method_id` string, required

## Response `200`

Successfully created walletLink

- object: Standard response containing data and its metadata if any
  - `data` CreateWalletLinkResponseDTO: Response payload containing the generated walletLink details
    - `authentication_redirect_url` string
    - `created_at` string
    - `id` string
  - `has_more` boolean

## Other responses

- `400`: Invalid request body or validation errors
- `401`: Missing or invalid credentials
- `422`: merchant_not_configured: the merchant has no live-mode configuration for this wallet
- `500`: Internal server error

---

[API](https://skmtc.dev/paymongo/apis/ewallets.md) - [All operations](https://skmtc.dev/paymongo/apis/ewallets/llms.txt) - [OpenAPI document](https://skmtc.dev/paymongo/apis/ewallets/revisions/a445ca65c132?raw)