Inicio rápido

curl -X POST https://e-cf.acpay.do/sandbox/v1/invoices \
  -H "Authorization: Bearer $ACPAY_TEST_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ecfType": 32,
    "paymentType": "cash",
    "items": [
      { "description": "Almuerzo ejecutivo", "quantity": 3, "unitPrice": 590, "priceIncludesItbis": true }
    ]
  }'

import { randomUUID } from 'node:crypto';

const BASE_URL = 'https://e-cf.acpay.do/sandbox/v1';

// Genera la llave una vez por factura y guárdala con ella: si reintentas,
// reutilízala para no emitir dos veces.
const idempotencyKey = randomUUID();

const response = await fetch(`${BASE_URL}/invoices`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.ACPAY_TEST_KEY}`,
    'Idempotency-Key': idempotencyKey,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    ecfType: 32,
    paymentType: 'cash',
    items: [
      { description: 'Almuerzo ejecutivo', quantity: 3, unitPrice: 590, priceIncludesItbis: true },
    ],
  }),
});

const body = await response.json();
if (!response.ok) {
  // Siempre { error: { status, message, details? } }
  throw new Error(`${response.status}: ${body.error.message}`);
}
// body.id: guárdalo para consultar el estado.

import os
import uuid

import requests

BASE_URL = "https://e-cf.acpay.do/sandbox/v1"

# Genera la llave una vez por factura y guárdala con ella: si reintentas,
# reutilízala para no emitir dos veces.
idempotency_key = str(uuid.uuid4())

response = requests.post(
    f"{BASE_URL}/invoices",
    headers={
        "Authorization": f"Bearer {os.environ['ACPAY_TEST_KEY']}",
        "Idempotency-Key": idempotency_key,
    },
    json={
        "ecfType": 32,
        "paymentType": "cash",
        "items": [
            {"description": "Almuerzo ejecutivo", "quantity": 3, "unitPrice": 590, "priceIncludesItbis": True}
        ],
    },
    timeout=60,
)

body = response.json()
if not response.ok:
    # Siempre {"error": {"status", "message", "details"?}}
    raise RuntimeError(f"{response.status_code}: {body['error']['message']}")
# body["id"]: guárdalo para consultar el estado.