# CertoPay

## Docs

- [Create a New Customer — POST /api/customers Guide](https://docs.v2.certopaybrasil.com/api-reference/customers/create.md): POST /api/customers — Register a new buyer in CertoPay. Accepts name, email, document (CPF), and phone. Returns the customer ID for use in orders.
- [Delete Customer Record — DELETE /api/customers/{id}](https://docs.v2.certopaybrasil.com/api-reference/customers/delete.md): DELETE /api/customers/{id} — Permanently remove a customer from your CertoPay account. This action is irreversible and cannot be undone.
- [Retrieve a Customer by UUID — GET /api/customers](https://docs.v2.certopaybrasil.com/api-reference/customers/get.md): GET /api/customers/{id} — Fetch a single customer by their UUID. Returns the full customer record including name, email, document, and phone.
- [List All Customers — GET /api/customers Reference](https://docs.v2.certopaybrasil.com/api-reference/customers/list.md): GET /api/customers — Retrieve all customers registered in your CertoPay account. Returns an array of customer objects with full details.
- [Update Customer Fields — PATCH /api/customers/{id}](https://docs.v2.certopaybrasil.com/api-reference/customers/update.md): PATCH /api/customers/{id} — Partially update a customer's details in CertoPay. Send only the fields you want to change; all others stay the same.
- [Create New Payment Order — POST /api/orders Guide](https://docs.v2.certopaybrasil.com/api-reference/orders/create.md): POST /api/orders — Create a payment order in CertoPay linking a customer to an amount in centavos. Returns the orderId for payment processing.
- [Retrieve an Order by UUID — GET /api/orders/{id}](https://docs.v2.certopaybrasil.com/api-reference/orders/get.md): GET /api/orders/{id} — Fetch a single order by UUID. Returns the order details including customer ID, amount, status, and creation date.
- [List All Orders — GET /api/orders Full Reference](https://docs.v2.certopaybrasil.com/api-reference/orders/list.md): GET /api/orders — Retrieve all orders in your CertoPay account. Returns an array of order objects including status, amount, and customer ID.
- [POST /api/payment-gateway/process — Process a Payment](https://docs.v2.certopaybrasil.com/api-reference/payments/process.md): POST /api/payment-gateway/process — Unified endpoint to process PIX, Boleto, and Credit Card payments. Always include an Idempotency-Key header.
- [POST /api/payment-gateway/refund — Issue a Refund](https://docs.v2.certopaybrasil.com/api-reference/payments/refund.md): POST /api/payment-gateway/refund — Issue a full or partial refund for a captured transaction. Partial refunds require the amount field in centavos.
- [POST /api/payment-gateway/tokenize-card — Tokenize a Card](https://docs.v2.certopaybrasil.com/api-reference/payments/tokenize-card.md): POST /api/payment-gateway/tokenize-card — Store a card as a reusable token and charge returning customers without handling raw card data again.
- [GET /api/transaction-events — List Transaction Events](https://docs.v2.certopaybrasil.com/api-reference/transactions/events.md): GET /api/transaction-events/transaction/{id} — Retrieve the full event history for a specific transaction, showing every status change in order.
- [GET /api/transactions/{transactionId} — Get Transaction](https://docs.v2.certopaybrasil.com/api-reference/transactions/get.md): GET /api/transactions/{transactionId} — Fetch a single transaction by ID. Confirm payment status before fulfilling orders or granting access.
- [GET /api/transactions — List All Payment Transactions](https://docs.v2.certopaybrasil.com/api-reference/transactions/list.md): GET /api/transactions — Retrieve all payment transactions in your CertoPay account. Returns an array with status, method, amount, and timestamps.
- [Disable a Registered Webhook — DELETE /api/webhooks](https://docs.v2.certopaybrasil.com/api-reference/webhooks/delete.md): DELETE /api/webhooks — Deactivate your CertoPay webhook endpoint. You will stop receiving transaction event notifications until a new URL is registered.
- [GET /api/webhooks/deliveries — Webhook Delivery History](https://docs.v2.certopaybrasil.com/api-reference/webhooks/deliveries.md): GET /api/webhooks/deliveries — View the delivery history for your CertoPay webhooks. Filter by status or event type to troubleshoot failed deliveries.
- [GET /api/webhooks — Retrieve Webhook Configuration](https://docs.v2.certopaybrasil.com/api-reference/webhooks/get.md): GET /api/webhooks — Retrieve your registered CertoPay webhook URL and its current status. Confirm your setup is correct before testing any payment flow.
- [Retry a Webhook Delivery — POST /api/webhooks/deliveries](https://docs.v2.certopaybrasil.com/api-reference/webhooks/retry.md): POST /api/webhooks/deliveries/{deliveryId}/retry — Manually trigger a retry for a failed webhook delivery. Useful for recovering missed transaction events.
- [Register or Update a Webhook — POST /api/webhooks/upsert](https://docs.v2.certopaybrasil.com/api-reference/webhooks/upsert.md): POST /api/webhooks/upsert — Register or update your webhook URL to receive real-time transaction event notifications from CertoPay.
- [API Authentication and Key Management for CertoPay](https://docs.v2.certopaybrasil.com/authentication.md): Authenticate every CertoPay API request using X-Api-Key or JWT Bearer tokens. Covers key retrieval, rotation, rate limits, and security best practices.
- [Idempotency Keys: Avoid Duplicate Charges in CertoPay](https://docs.v2.certopaybrasil.com/best-practices/idempotency.md): Use Idempotency-Key headers to safely retry failed payment requests without charging the buyer twice. Learn the 24-hour key lifecycle and retry strategy.
- [CertoPay API Security: Key Storage and Best Practices](https://docs.v2.certopaybrasil.com/best-practices/security.md): Keep your CertoPay API Key secure. Covers key storage, rotation, webhook verification, and rate limit handling for production integrations.
- [CertoPay API Error Codes and Integration Troubleshooting](https://docs.v2.certopaybrasil.com/errors.md): Reference for CertoPay API error codes and HTTP status codes. Learn what each error means and how to resolve the most common integration issues.
- [CertoPay: Payment Gateway for Developers](https://docs.v2.certopaybrasil.com/introduction.md): CertoPay is a Brazilian PSP API that enables PIX, Boleto, and Credit Card payments. Learn what you can build and how the API is structured.
- [Boleto Payments with CertoPay: Barcodes and PDF Slips](https://docs.v2.certopaybrasil.com/payments/boleto.md): Issue Boleto banking slips through CertoPay. Get the barcode, digitableLine, and a PDF link. Payment confirmed via webhook within 1-3 business days.
- [Credit Card Payments with CertoPay: Visa, Mastercard, Elo](https://docs.v2.certopaybrasil.com/payments/credit-card.md): Process Visa, Mastercard, and Elo credit cards with installments. Use card tokenization for repeat customers and recurring charges.
- [CertoPay Payment Methods: PIX, Boleto, and Credit Card](https://docs.v2.certopaybrasil.com/payments/overview.md): CertoPay supports PIX, Boleto, and Credit Card payments through a single unified endpoint. Learn when to use each method and how they differ.
- [PIX Payments with CertoPay: QR Codes and EMV Codes](https://docs.v2.certopaybrasil.com/payments/pix.md): Generate PIX QR Codes and EMV copy-paste codes instantly. CertoPay handles PIX key management and sends a webhook when payment is confirmed.
- [CertoPay Quickstart: Your First Payment in 4 Steps](https://docs.v2.certopaybrasil.com/quickstart.md): Make your first PIX payment with CertoPay in under 5 minutes. Create a customer, create an order, process a payment, and verify the transaction.
- [CertoPay Webhook Events: All Transaction Lifecycle Events](https://docs.v2.certopaybrasil.com/webhooks/events.md): Complete list of webhook events fired by CertoPay. Covers all transaction lifecycle changes including payment, refund, chargeback, and expiration.
- [CertoPay Webhooks: Receive Real-Time Payment Events](https://docs.v2.certopaybrasil.com/webhooks/overview.md): Configure a webhook endpoint to receive real-time CertoPay transaction events. Register your URL, handle delivery retries, and verify event authenticity.