---
updatedAt: 2026-07-08T12:34:10.000Z
agentTools:
  projectIndex: https://developer.coingate.com/llms.txt
---

# Create Payment Channel

Create a new payment channel to receive crypto payments for a specific contact. The payment channel defines the receive currency, callback URL for notifications, and optionally generates crypto addresses for specified asset and platform combinations.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "v2",
    "version": "2"
  },
  "servers": [
    {
      "url": "https://api.coingate.com/api/v2"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/payment_channels": {
      "post": {
        "description": "",
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "OK": {
                    "summary": "OK",
                    "value": {
                      "id": 76,
                      "contact_id": 40,
                      "payment_purpose": "Subscription fees",
                      "callback_url": "https://example.com/webhooks/payment-channels",
                      "receive_currency_id": 1,
                      "status": "active",
                      "created_at": "2026-06-09T05:43:14.172Z",
                      "addresses": [
                        {
                          "currency_id": 1,
                          "platform_id": 4,
                          "address": null,
                          "memo": "",
                          "status": "enqueued"
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer",
                      "example": 76,
                      "default": 0
                    },
                    "contact_id": {
                      "type": "integer",
                      "example": 40,
                      "default": 0
                    },
                    "payment_purpose": {
                      "type": "string",
                      "example": "Subscription fees"
                    },
                    "callback_url": {
                      "type": "string",
                      "example": "https://example.com/webhooks/payment-channels"
                    },
                    "receive_currency_id": {
                      "type": "integer",
                      "example": 1,
                      "default": 0
                    },
                    "status": {
                      "type": "string",
                      "example": "active"
                    },
                    "created_at": {
                      "type": "string",
                      "example": "2026-06-09T05:43:14.172Z"
                    },
                    "addresses": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "currency_id": {
                            "type": "integer",
                            "example": 1,
                            "default": 0
                          },
                          "platform_id": {
                            "type": "integer",
                            "example": 4,
                            "default": 0
                          },
                          "address": {},
                          "memo": {
                            "type": "string",
                            "example": ""
                          },
                          "expires_at": {},
                          "status": {
                            "type": "string",
                            "example": "enqueued"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "Payment channel is not valid"
                    },
                    "reason": {
                      "type": "string",
                      "example": "PaymentChannelIsNotValid"
                    },
                    "errors": {
                      "type": "object",
                      "properties": {
                        "contact_id": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "example": "is already assigned to another payment channel"
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "422": {
                    "summary": "422",
                    "value": {
                      "message": "Payment channel is not valid",
                      "reason": "PaymentChannelIsNotValid",
                      "errors": {
                        "contact_id": [
                          "is already assigned to another payment channel"
                        ]
                      }
                    }
                  }
                }
              }
            },
            "description": "422"
          }
        },
        "parameters": [],
        "operationId": "post_payment-channels",
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "contact_id": {
                    "type": "integer",
                    "description": "Contact to associate with this channel. Must belong to the same merchant, have all required travel-rule fields filled, and not already be assigned to another payment channel (a contact maps to at most one channel)."
                  },
                  "receive_currency_id": {
                    "type": "integer",
                    "description": "Currency the merchant wants to receive. Must be enabled and support merchant receive."
                  },
                  "payment_purpose": {
                    "type": "string",
                    "description": "Purpose of the payment (e.g. merchant_payment, subscription, donation)."
                  },
                  "callback_url": {
                    "type": "string",
                    "description": "URL to receive webhook notifications for transactions on this channel."
                  },
                  "assets": {
                    "type": "array",
                    "description": "Crypto assets to generate addresses for. New addresses start enqueued (null address) and become active within ~1 min. Each item: currency_id (integer, required), platform_id (integer, required).",
                    "items": {
                      "properties": {},
                      "type": "object"
                    }
                  }
                },
                "required": [
                  "contact_id",
                  "receive_currency_id"
                ]
              }
            }
          }
        },
        "summary": "Create Payment Channel"
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```