# Create
Create authorization is also known as Reservation of funds
An authorization is the reservation of a specified amount of money on a cardholder's credit/debit card. Authorization can be made for purpose of a one-off payment or for a recurring payment.
An authorization often requires 3D Secure verification, e.g. if the amount is large enough or when creating an initial recurring authorization. Cardholder will be required to verify through a SCA challenge. Depending on the type of your integration, 3D Secure might be performed by Intergiro or by the integrating party.
A created authorization can be captured
, canceled
or refunded
.
To create an Authorization
, you need to prepare an Authorization creatable
.
Example:
POST /v1/authorization
Host: merchant.intergiro.com
Content-Type: application/json
Authorization: Bearer <public.api.key>
{
"amount": 23.41,
"currency": "EUR",
"card": {
"pan": "4111111111111111",
"expires": [2, 22],
"csc": "987"
},
"browser": // <browser object>
}
Response:
HTTP 200 OK
{
"id": "<intergiro_tx_id>",
"merchant": "testtest",
"amount": 23.41,
"currency": "EUR",
"history": [],
"change": [],
"capture": [],
"refund": [],
"created": "2021-04-01T09:00:00.000Z",
"reference": "12341234",
"card": {
"csc": "matched",
"expires": [2, 22],
"iin": "411111",
"last4": "1111",
"scheme": "visa",
"type": "debit",
},
}
See browser
section for information on browser information.
← External flow Capture →