# Criar metodo de pagamento custom

`POST /instance/account/pay/custom-method`

Pasta: **Instancia**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Criar método de pagamento custom

Registra um método de pagamento custom na conta (`w:pay` / `create-custom-payment-method`). Use o atalho `/instance/account/pay/pix-key` para PIX.

## Endpoint

``` http
POST {{baseUrl}}/instance/account/pay/custom-method
```

## Autenticação

``` http
token: {{token}}
```

## Corpo

``` json
{
  "country": "BR",
  "type": "pix_key",
  "flow": "p2m",
  "metadata": {
    "pix_key_type": "CPF",
    "pix_display_name": "Loja Exemplo",
    "pix_key": "00000000000"
  }
}
```

## Resposta

``` json
{
  "success": true,
  "method": {
    "credential_id": "…",
    "country": "BR",
    "type": "pix_key",
    "flow": "p2m",
    "metadata": {
      "pix_key_type": "CPF",
      "pix_display_name": "Loja Exemplo",
      "pix_key": "00000000000"
    }
  }
}
```

## Observações

Mobile only. `device_id` opcional (usa o DeviceID da sessão quando omitido). `flow` padrão: `p2m`.

## Corpo (exemplo)

```json
{
  "country": "BR",
  "type": "pix_key",
  "flow": "p2m",
  "metadata": {
    "pix_key_type": "CPF",
    "pix_display_name": "Loja Exemplo",
    "pix_key": "00000000000"
  }
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/instance/account/pay/custom-method" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "country": "BR",
  "type": "pix_key",
  "flow": "p2m",
  "metadata": {
    "pix_key_type": "CPF",
    "pix_display_name": "Loja Exemplo",
    "pix_key": "00000000000"
  }
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=instancia/criar-metodo-de-pagamento-custom)