curl https://api.onepay.la/v1/invoices \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "x-idempotency: invoice-001" \
  -d '{
    "reference": "1060500333",
    "provider_id": "987654",
    "provider": "biller",
    "amount": 50000,
    "name": "Internet plan - Octubre",
    "description": "Factura de internet correspondiente al mes de octubre 2025",
    "phone": "+573167591030",
    "email": "cliente@ejemplo.com",
    "due_date": "2025-10-20",
    "document_url": "https://example.com/document.pdf",
    "metadata": {
      "key": "value"
    }
  }'

const response = await fetch('https://api.onepay.la/v1/invoices', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_test_xxx',
    'Content-Type': 'application/json',
    'x-idempotency': 'invoice-001'
  },
  body: JSON.stringify({
    reference: '1060500333',
    provider_id: '987654',
    provider: 'biller',
    amount: 50000,
    name: 'Internet plan - Octubre',
    description: 'Factura de internet correspondiente al mes de octubre 2025',
    phone: '+573167591030',
    email: 'cliente@ejemplo.com',
    due_date: '2025-10-20',
    document_url: 'https://example.com/document.pdf',
    metadata: {
      key: 'value'
    }
  })
});

const invoice = await response.json();

import requests

response = requests.post(
    'https://api.onepay.la/v1/invoices',
    headers={
        'Authorization': 'Bearer sk_test_xxx',
        'Content-Type': 'application/json',
        'x-idempotency': 'invoice-001'
    },
    json={
        'reference': '1060500333',
        'provider_id': '987654',
        'provider': 'biller',
        'amount': 50000,
        'name': 'Internet plan - Octubre',
        'description': 'Factura de internet correspondiente al mes de octubre 2025',
        'phone': '+573167591030',
        'email': 'cliente@ejemplo.com',
        'due_date': '2025-10-20',
        'document_url': 'https://example.com/document.pdf',
        'metadata': {
            'key': 'value'
        }
    }
)

invoice = response.json()

<?php
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.onepay.la/v1/invoices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer sk_test_xxx",
    "Content-Type: application/json",
    "x-idempotency: invoice-001"
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "reference" => "1060500333",
    "provider_id" => "987654",
    "provider" => "biller",
    "amount" => 50000,
    "name" => "Internet plan - Octubre",
    "description" => "Factura de internet correspondiente al mes de octubre 2025",
    "phone" => "+573167591030",
    "email" => "cliente@ejemplo.com",
    "due_date" => "2025-10-20",
    "document_url" => "https://example.com/document.pdf",
    "metadata" => [
      "key" => "value"
    ]
  ])
]);

$response = curl_exec($curl);
$invoice = json_decode($response, true);
?>

{
  "id": "9da58912-101d-46f8-86c9-20a52119c0bf",
  "name": "Internet plan - Octubre",
  "description": "Factura de internet correspondiente al mes de octubre 2025",
  "amount": 50000,
  "provider": "biller",
  "provider_id": "987654",
  "reference": "1060500333",
  "status": "CREATED",
  "remarks": null,
  "metadata": { "key": "value" },
  "due_date": null,
  "created_at": "2025-10-20T15:06:00.000000Z",
  "updated_at": "2025-10-20T15:06:00.000000Z",
  "payment_id": "c1f4b0aa-6a12-4471-8a3d-1a2b3c4d5e6f",
  "is_test": false,
  "partial_payment_config": null,
  "payment": {
    "id": "c1f4b0aa-6a12-4471-8a3d-1a2b3c4d5e6f",
    "source": "Internet plan - Octubre",
    "currency": "COP",
    "amount": 50000,
    "amount_label": "$ 50.000",
    "title": "Internet plan - Octubre",
    "description": "Internet plan - Octubre",
    "phone": "+573167591030",
    "expiration_at": null,
    "due_date": null,
    "document_link": "https://example.com/document.pdf",
    "external_id": "987654",
    "allows": { "accounts": true, "cards": true, "card_extra": false, "realtime": false },
    "status": "pending",
    "is_test": false,
    "created_at": "2025-10-20T15:06:00.000000Z",
    "paid_at": null,
    "payment_link": "https://pagos.onepay.la/payment/c1f4b0aa-6a12-4471-8a3d-1a2b3c4d5e6f",
    "redirect_url": null,
    "provider_id": null,
    "metadata": null,
    "customer": null,
    "method": null,
    "splits": [],
    "company": null,
    "commission": null
  }
}

{
  "id": "9da58912-101d-46f8-86c9-20a52119c0bf",
  "name": "Internet plan - Octubre",
  "amount": 50000,
  "provider": "biller",
  "provider_id": "987654",
  "reference": "1060500333",
  "status": "CREATED",
  "remarks": null,
  "metadata": { "key": "value" },
  "due_date": null,
  "created_at": "2025-10-20T15:06:00.000000Z",
  "updated_at": "2025-10-20T15:06:00.000000Z",
  "payment_id": "c1f4b0aa-6a12-4471-8a3d-1a2b3c4d5e6f",
  "is_test": false,
  "partial_payment_config": {
    "min_amount_in_cents": 1000000,
    "max_amount_in_cents": null,
    "max_payment_methods": 3,
    "timeout_hours": 24
  },
  "payment": {
    "id": "c1f4b0aa-6a12-4471-8a3d-1a2b3c4d5e6f",
    "source": "Internet plan - Octubre",
    "currency": "COP",
    "amount": 50000,
    "amount_label": "$ 50.000",
    "title": "Internet plan - Octubre",
    "description": "Internet plan - Octubre",
    "phone": "+573167591030",
    "expiration_at": null,
    "due_date": null,
    "document_link": "https://example.com/document.pdf",
    "external_id": "987654",
    "allows": { "accounts": true, "cards": true, "card_extra": false, "realtime": false },
    "status": "pending",
    "is_test": false,
    "created_at": "2025-10-20T15:06:00.000000Z",
    "paid_at": null,
    "payment_link": "https://pagos.onepay.la/payment/c1f4b0aa-6a12-4471-8a3d-1a2b3c4d5e6f",
    "redirect_url": null,
    "provider_id": null,
    "metadata": null,
    "customer": null,
    "method": null,
    "splits": [],
    "company": null,
    "commission": null,
    "partial_payment": {
      "total_paid_in_cents": 0,
      "total_paid_label": "$ 0",
      "remaining_amount_in_cents": 5000000,
      "remaining_label": "$ 50.000",
      "progress_percentage": 0,
      "is_fully_paid": false,
      "min_amount_in_cents": 1000000,
      "max_amount_in_cents": null,
      "max_payment_methods": 3,
      "timeout_hours": 24,
      "partial_expires_at": null,
      "charges": []
    }
  }
}

{
  "message":"La solicitud contiene errores de validación.",
  "code":10001,
  "code_name":"validation_error",
  "errors":{
    "reference":["El campo referencia es obligatorio."],
    "amount":["El monto debe ser al menos 5000."],
    "name":["El nombre debe tener al menos 5 caracteres."],
    "phone":["El teléfono debe estar en formato E.164."],
    "email":["El correo electrónico no es válido."]
  }
}

{
  "message": "No se puede generar la operación, genera un token de idempotencia y envíelo en los headers como x-idempotency",
  "code": 10003,
  "code_name": "idempotency_error"
}