Udvikler platform

API'en er kernen.
Oplevelsen er stadig din.

Byg betalinger direkte ind i dit produkt. En API REST til kunder, kort, Pix, boleto og kredit med SDKs, webhooks og dedikerede referencer til Transactional, Betalingslinks, Sellers, Opdeling af Betalinger og Udgiftsstyring.

REST APISandboxNode.jsPHP / LaravelWebhooksBetalingslinksOpdeling af Betalinger
POST /api/v1/transaction/new/:CustomerID
ny kreditkorttransaktion
application/json
{
  "amount": 14990,
  "currency": "BRL",
  "description": "Pedido #102938",
  "id_card": "23082eb67cd54e7eb4c9cf8c760bd12f",
  "capture": 1,
  "statement_descriptor": "IOPAY STORE",
  "installment_plan": {
    "number_installments": 1
  },
  "io_seller_id": "<IO_SELLER_ID>",
  "payment_type": "credit",
  "reference_id": "102938"
}
application/json Transaktionssvar
{
  "success": {
    "id": "7f38b2c94e1a4d69a81f53b76d9c204e",
    "resource": "transaction",
    "status": "succeeded",
    "payment_type": "credit",
    "amount": "149.90",
    "captured": true,
    "currency": "BRL",
    "reference_id": "102938",
    "payment_method": {
      "resource": "card",
      "card_brand": "Visa",
      "last4_digits": "4242"
    },
    "installment_plan": {
      "mode": "interest_free",
      "number_installments": "1"
    },
    "created_at": "2026-10-06T20:09:48+00:00"
  }
}
Kort uden at genoptage data.Brug id_card allerede tilknyttet customer og opret transaktionen.
IOPAY-dokumentation

APIs og Documented and Organized Integration Referencer

Udvid betalings produkter og tjenester som en service. Start med API Base og gå videre til den specifikke reference for dens gennemførelse. Transaktionel, Betalingslinks, Sellers, Opdeling af Betalinger, Konsultationer, Tokenisering og Udgiftsstyring er organiseret du hurtigt komme til den rigtige reference.

docs-api.iopay.com.br
Offentlig dokumentation
Basis-API

Grundlaget for deres integration.

Det starter med autentificering, opsætning af miljø, kunder, kort og toxization. Transaktionslaget går ind i næste fase.

InstituttetBasis-API
AUTHBearer tokenAdgang
POSTv1/customer/newKunde
POSTv1/card/tokenize/tokenTokenize
ENVsandbox / productionMiljøer
Transaktions-API

Fra den betaling, der er oprettet til hele transaktionscyklussen.

Koncentrer her de transaktionsmæssige operationer af Pix, kort og boleto: oprettelse, høring, fange, annullering, returnering og statusovervågning.

BetalingerTransaktions-API
POSTv1/transaction/new/:CustomerIDOpret
GETv1/transaction/get/:idSe
CAPcaptura total ou parcialFangst
VOIDcancelamento / estornoCyklus
Postman · Betalingslinks API V2

Gør en ladning til en URL.

API V2 omfatter link oprettelse, forespørgsel, opdatering, sletning og notering, samt forespørgsel af de genererede transaktioner. Opsætning af elementer, betalingsmidler, rater, renter, tilgængelighed, Order Bump, visuel identitet og Split når aktiveret.

V2-konfigurationBetalingslink
ITEMtitle + items[]Betalingsanmodning
PAYcredit / pix / boletoMetoder
TIMEopen_at / end_at / max_paymentsTilgængelighed
CARDmax_installment + interestRatebetaling
BUMPorder_bump_items[]Yderligere tilbud
BRANDprimary_color + bannersIdentitet
SPLITsplit_rules[]Distribution
Postman · Sellers API

Deltagere behandlet som en del af arkitekturen.

Se den specifikke reference for implementering af Sellers-relaterede platformfunktioner og holde dette lag adskilt fra den transaktionsmæssige kerne.

Postman Offentlig indsamling
Sellers APIPlatformens deltagere
Postman · Opdeling af Betalinger

Opdeling af Betalinger med egen reference.

Brug den dedikerede samling til at implementere Opdeling af Betalinger-regler i flerpartiers operationer, så dette lag holdes adskilt fra API Base og Transaktions-API.

Postman Offentlig indsamling
Opdeling af Betalingerreglerne for Opdeling af Betalinger
Udgiftsstyring og Firmakort

Firmakontrol forbundet til platformen.

En særlig front for udstedelse og forvaltning af firmakort, fastsættelse af grænser, politikker for brug, luftfartsselskaber og overvågning af udgifter.

VirksomhedFirmakort
CARDemissão e gestão por empresaKort
RULElimites e políticas de usoKontrol
TEAMportadores e centros de custoTeam
VIEWvisão consolidada de gastosDrift
Hurtig start

Fra den første anmodning
- Den første ladning.
I tre trin.

Indstil autentificering, oprette customer og administrere en Pix opladning ved hjælp af samme flow din ansøgning vil tage til produktion.

Første integration

En genvej til at forstå API 's struktur, før du udforsker de andre funktioner.

Åbn referencen API -
01
Aktivt trinGodkendelse af anmodninger
Trin 01 · Adgang

Godkendelse af anmodninger

Hver integration starter med det rigtige miljø og en gyldig token i Autorisations header.

Bearer tokenSandboxProduktion
Mål

Din ansøgning er nu godkendt til API IOPAY.

Forventet afkast

Herfra kan du kalde de næste integrationsveje.

Hvor bliver den af?

I begyndelsen af enhver integration, før du opretter kunder eller transaktioner.

Checkliste over
  • Vælg sandkasse eller produktion.
  • Tilføjelse: Beater seu_token.
  • Indsend content- Type: ansøgning / json.
Eksempel på godkendelse
Docs...
curl --request GET \
  --url https://api.iopay.com.br/api/v1/customer/get/:customerId \
  --header 'Authorization: Bearer seu_token' \
  --header 'Content-Type: application/json'
Næste trin

Med godkendelse klar, det næste skridt er at skabe den køber, der vil modtage afgiften.

Authorization: Bearer seu_token





Betalingsmidler

Det er en integration.Hver betaling,
Din egen rejse.

Pix, kort og boleto bor i den transaktionsmæssige kerne. Betaling Linkss bære den samme infrastruktur til assisteret salg, fjernopladning og kanaler uden egen check.

PIX

Pix

Opret øjeblikkelige regninger, QR Code og følg op bekræftelse efter begivenhed.

Ideel til udtjekning, fjernfakturering og øjeblikkelige betalingsstrømme.
CC

Kort

Kreditbetaling uden rater eller parcelling, additionalisering og tilbagekøb eller tilbagefald betalingsforløb.

Det giver dig mulighed for at kombinere egen udtjekning med godkendelse strømme af operationen.
BLT

Boleto

Udstedelse og opfølgning af gebyrer for betalingsforløb, der kræver betaling af titel.

Modtagelseserklæringen kan integreres i virksomhedens interne processer.
LNK

Betalingslinks

Opret delte, hostede gebyrer for API at sælge uden for den traditionelle checkout.

CRM, WhatsApp, intern salg, service og deltog i betalingsforløb.


Webhooks + hændelser

Dit system behøver ikke at spørge.
Iopay vil blive alarmeret om få sekunder.

HTTP POST Realtid Ingen afstemning

IOPAY modtager betalingsopdateringen, behandler den nye status og sender webhook til sit endepunkt. Lav friktion, klar strømning og synkroniseret systemer.

Stol på webhooks lag og robuste Iopay begivenheder med automatisk genlevering i tilfælde af din server manglende tilgængelighed.

01 · Oprindelse Lønnen ændrer sig.

Ny tilstand af infrastrukturen.

→→→→→→→→→→→→→→
03 · Dens system webhook er her. Det gør jeg altid.

Dit endpoint modtager POST anmodning fra Iopay og du behandler og reagerer som du vil. Dit system træffer foranstaltninger efter en betaling er blevet oprettet, godkendt, mislykkedes, trukket tilbage eller delvist annulleret. Med confimation dit system har alt at frigive anmodningen, foder CRM Buddherp, interagere med SAP, integrere fullfilment og selvangivelse.

SDKs IOPAY

SDKs for Java, JavaScript, Node.js og
PHP / Laravel.

Brug de offentlige IOPAY klienter i Node.js og PHP / Laravel eller integrere direkte af API REST på ethvert sprog. Mindre scheduerplate til at starte med, uden at miste adgang til HTTP platform kontrakt.

De officielle SDK · Node.js

Klar til integration med JavaScript applikationer.

Offentlig klient med autentificering, miljøer, toxization, kunder og store transaktioner.

Installation
npm install
@iopay-payments/iopay-api-sdk-nodejs

// depois, use o client IOPAY no projeto
Officiel SDK · PHP

Komponist til PHP eller Laravel projekter.

Den officielle pakning iopay-payments/sdk-php kan installeres via Composer og bruges af projektet auto belastning, herunder i Laravel applikationer.

Installation af Komponist
composer require
iopay-payments/sdk-php

// disponível no vendor/autoload.php do projeto
REST API · enhver stak

Brug HTTP direkte, når du ønsker total kontrol.

Python, Go, Java, .NET, Ruby eller enhver anden stak kan forbruge API IOPAY direkte via HTTPS, ved hjælp af de samme offentliggjorte endpoints og kontrakter.

Universal eksempel
curl --request GET \\
  --url https://api.iopay.com.br/api/v1/customer/get/:CustomerID \\
  --header 'Authorization: Bearer seu_token' \\
  --header 'Content-Type: application/json'
Drift

Integration og operation skal tale samme sprog.

Efter implementering, ingeniørarbejde, produkt, finansiering og service skal se den samme gevinst. IOPAY portalen supplerer API med transaktionsvision, tilgodehavender, legitimation, rapporter og operationel overvågning.

01Transaktioner Se status, klient, metode, værdi og referencer for transaktionen.
02Tilgodehavender Hold styr på de finansielle udsigter i forbindelse med det forarbejdede salg.
03Adgangsoplysninger Centrér de data, der er nødvendige for integrationsmiljøer.
04Rapporter Støtte rutinemæssige operationer og forsoning uden udelukkende at stole på ingeniørholdet.
Operationer IOPAYKonsolideret vision
TRANSAKTIONER883
GODKENDELSE60,4%
TPVR$ 2,58M
TransaktionMetodeStatus forBeløb
0b527...9a6creditGodkendtR$ 1.002
44d23...9044pixAndre varerR$ 3.482
34fad...29e7creditGodkendtR$ 5.444
Sikkerhed og arkitektur som kerne og fundament princip

APIs og arkitektur beregnet til drift
betalinger med kontrol, sikkerhed og vision.

Valgret, miljøadskillelse, tilpasning og sikkerhedskontrol er en del af produktarkitekturen og reducerer unødvendig eksponering for følsomme data.

01Separerede legitimationsoplysninger

Separat udvikling, afprøvning og produktion med legitimationsoplysninger, der passer til hvert miljø.

02Tokenisering

Reducerer strømmen af følsomme data i buyback, hentning og en-klik betalingsforløb.

03PCI DSS 4.0.1

Kontrol af betalingssikkerhed og miljøbeskyttelse i forbindelse med IOPAY-infrastrukturen.

04Begivenheder og sporbarhed

Brug identifikatorer, status og webhooks til at spore transaktionscyklussen og reagere på undtagelser.

Brugstilfælde

Arkitektur for forskellige
forretningsmodeller.

Udvikler Platform IOPAY er designet til produkter, der har brug for at indarbejde betalinger i e-handel oplevelse sig til SaaS, markedsplads, ERP og assisteret salg.

E-handel

Tjek dig selv.

Styr køberens oplevelse, mens IOPAY kører betaling og begivenhed lag.

Se e-handel →
SaaS- recidiv

Genopladning og kontinuerlig ladning.

Det kombinerer toxization, kunder, begivenheder, og logik i sin ansøgning om tilbagevendende betalingsforløb.

Se også dokumentation →
Marketplaces

Sellers og Opdeling af Betalinger.

Tag højde for Sellers 's kontekst og Opdeling af Betalinger' s regler for transaktionsstrømmen.

Se markedspladser →
ERP-finansiering

Betalinger i forbindelse med operationen.

Indgå regninger og begivenheder i interne afviklings-, service- og finansielle processer.

Tale med en ekspert →
Indendørs salg

Angrib inde i tragten.

Administrer links eller transaktioner fra CRM og returstatus for salg, on-boarding og finansiering.

Se også links →
White-label

Infrastruktur under din erfaring.

Kombiner APIs og platformfunktioner til at tilbyde betalte betalingsforløb integreret med dit mærke.

Se hvid- etiket →
Integration og APIs IO

Fra første kald til produktion. Stol på den bedste betalingsløsning arkitektur

Udforsk dokumentationen, test dens integration og lette betalinger ind i dit produkt med IOPAY infrastruktur.