> For the complete documentation index, see [llms.txt](https://docs.pagsmile.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagsmile.com/reference/payin/submit-a-payin/argentina/debin.md).

# DEBIN

Use this endpoint to submit a DEBIN payment in Argentina. The customer must provide a CBU, CVU, or account alias together with their name and identification information. After the payment request is created, redirect the customer to the returned `pay_url` to authorize the payment.

{% hint style="warning" %}
The payment amount must be between `1,750` and `5,000,000` ARS. Requests outside this range may be rejected. Refunds are not supported for this payment method.
{% endhint %}

### Endpoint

For sandbox testing, use:

<mark style="color:green;">`POST`</mark> `https://gateway-test.pagsmile.com/trade/pay`

### Request headers

<table><thead><tr><th width="182.546875">Header</th><th width="120.81640625">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>Content-Type</code></td><td>Yes</td><td>Fixed value: <code>application/json</code>.</td></tr><tr><td><code>Authorization</code></td><td>Yes</td><td>Basic authentication using <code>Base64(app_id:security_key)</code>.</td></tr></tbody></table>

### Request body

<table><thead><tr><th width="170.78515625">Parameter</th><th width="96.6875">Type</th><th width="106.40625">Required</th><th>Constraints</th><th>Description</th></tr></thead><tbody><tr><td><code>app_id</code></td><td>string</td><td>Yes</td><td>Must not exceed 32 characters.</td><td>Merchant application ID assigned by Pagsmile.</td></tr><tr><td><code>out_trade_no</code></td><td>string</td><td>Yes</td><td>Must not exceed 64 characters and must be unique for the merchant application.</td><td>Merchant order number.</td></tr><tr><td><code>method</code></td><td>string</td><td>Yes</td><td>Fixed value: <code>DEBIN</code>.</td><td>Payment method.</td></tr><tr><td><code>order_amount</code></td><td>decimal</td><td>Yes</td><td>Must be from <code>1,750</code> to <code>5,000,000</code> ARS and may contain up to two decimal places.</td><td>Payment amount.</td></tr><tr><td><code>order_currency</code></td><td>string</td><td>Yes</td><td>Fixed value: <code>ARS</code>.</td><td>Payment currency.</td></tr><tr><td><code>subject</code></td><td>string</td><td>Yes</td><td>Must not exceed 128 characters.</td><td>Payment subject or order title.</td></tr><tr><td><code>content</code></td><td>string</td><td>Yes</td><td>Must not exceed 255 characters.</td><td>Payment description.</td></tr><tr><td><code>notify_url</code></td><td>string</td><td>Yes</td><td>Must be a valid URL; HTTPS is recommended.</td><td>Endpoint that receives asynchronous payment notifications.</td></tr><tr><td><code>return_url</code></td><td>string</td><td>No</td><td>Must be a valid URL; HTTPS is recommended.</td><td>URL to which the customer is redirected after completing the payment flow.</td></tr><tr><td><code>buyer_id</code></td><td>string</td><td>Yes</td><td>Must not exceed 128 characters.</td><td>Merchant-side customer ID.</td></tr><tr><td><code>timestamp</code></td><td>string</td><td>Yes</td><td>Must use the <code>yyyy-MM-dd HH:mm:ss</code> format and must not exceed 19 characters.</td><td>Time at which the request is sent.</td></tr><tr><td><code>timeout_express</code></td><td>string</td><td>No</td><td>Must use a supported expiration expression, such as <code>1c</code>. The DEBIN payment request remains valid for up to five days; use the returned <code>due_date</code> as the authoritative deadline.</td><td>Merchant-specified payment expiration expression.</td></tr><tr><td><code>account_type</code></td><td>string</td><td>Yes</td><td>One of: <code>CBU/CVU</code>, <code>Alias</code>. Use <code>CBU/CVU</code> when providing a 22-digit account identifier and <code>Alias</code> when providing an account alias.</td><td>Type of account identifier supplied in <code>account_number</code>.</td></tr><tr><td><code>account_number</code></td><td>string</td><td>Yes</td><td>When <code>account_type</code> is <code>CBU/CVU</code>, provide a valid 22-digit CBU or CVU without spaces or separators. When <code>account_type</code> is <code>Alias</code>, provide a valid alias linked to the customer's CBU or CVU.</td><td>Bank or virtual account identifier to be debited.</td></tr><tr><td><code>customer.identify.type</code></td><td>string</td><td>Yes</td><td>One of: <code>DNI</code>, <code>CUIT</code>. The value must match the document supplied in <code>customer.identify.number</code>.</td><td>Customer identification type.</td></tr><tr><td><code>customer.identify.number</code></td><td>string</td><td>Yes</td><td>Provide a valid identification number corresponding to <code>customer.identify.type</code>: 8 digits for <code>DNI</code> or 11 digits for <code>CUIT</code>.</td><td>Customer identification number.</td></tr><tr><td><code>customer.name</code></td><td>string</td><td>Yes</td><td>Provide the account holder's full name.</td><td>Customer name.</td></tr></tbody></table>

### Request example

```json
{
  "app_id": "165***62",
  "out_trade_no": "out_***00",
  "method": "DEBIN",
  "order_amount": "1801",
  "order_currency": "ARS",
  "subject": "trade pay test",
  "content": "trade pay test content",
  "notify_url": "https://merchant.example.com/payment/notify",
  "return_url": "https://merchant.example.com/payment/result",
  "buyer_id": "agt",
  "timestamp": "2026-08-16 13:18:10",
  "timeout_express": "1c",
  "account_type": "CBU/CVU",
  "account_number": "07***90",
  "customer": {
    "identify": {
      "type": "CUIT",
      "number": "20***9"
    },
    "name": "Test User"
  }
}
```

To use an account alias, set `account_type` to `Alias` and provide the alias in `account_number`.

### Response example

```json
{
  "code": "10000",
  "msg": "Success",
  "prepay_id": "cG***858",
  "trade_no": "202***76",
  "out_trade_no": "out_***00",
  "web_url": "",
  "pay_url": "https://checkout.pagsmile.com/checkout?prepay_id=cG***58",
  "trade_status": "PROCESSING",
  "due_date": "2026-08-21T00:00:00-03:00"
}
```

### Complete the payment

1. Redirect the customer's browser to the complete `pay_url` returned by Pagsmile.
2. Do not construct or modify the payment URL.
3. Allow the customer to complete the DEBIN authorization flow before `due_date`.
4. Use the payment notification or the Payin Detail API to determine the final payment status.

{% hint style="warning" %}
A successful API response with `code=10000` only confirms that the payment request was created. `trade_status=PROCESSING` does not mean that the payment has been completed. Do not deliver goods or services until the final paid status is confirmed.
{% endhint %}