# 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.