Intergiro developer portal

# Embedded finance

Business banking

# Accounts

Accounts are fundamental and serve as a basis for other value-add services that we offer.

# Create a new current account

Example create account request:

 








POST /v3/accounts

Content-Type: application/json
Authorization: Bearer <access_token>

{
  "individual_id": "bd4af0ff-0a72-4e09-b247-c6d8c2391496"
}

Response:

 









HTTP 200 OK

{
  "id": "8942eaf9-80b3-4060-a0b7-e03c35ca12f4",
  "name": "EUR account",
  "currency": "EUR",
  "balance": 0,
  "created_at": "2021-02-08T14:09:15.000Z"
}

# Fund account

Wiring money into the account requires bank account details like bank code and account number.

These can be easily accessed by calling GET /v3/accounts/:id/bank_details:

 




POST /v3/accounts/8942eaf9-80b3-4060-a0b7-e03c35ca12f4/bank_details

Content-Type: application/json
Authorization: Bearer <access_token>

Response:

 


 
 











HTTP 200 OK

{
  "payment_rail": "sepa",
  "details": {
    "iban": "SE0097700000000000000001",
    "bic": "FTCSSESSXXX"
  },
  beneficiary: {
    "street1": "Regeringsgatan 59",
    "city": "Stockholm",
    "country_code": "SE",
    "post_code": "111 56"
  }
}

# Payments

There are two ways to transfer money:

  • move money between individual's own accounts
  • pay to somebody else's account using account ID or IBAN

# Make a transfer

Internal transfers enable instant movement of funds between same-currency accounts belonging to the same individual. This can serve as a good way to fund someone's dedicated card account with the funds from another of their accounts.

Example move funds request:

 












POST /v3/transactions/move

Content-Type: application/json
Authorization: Bearer <access_token>

{
  "request_id": "9b68d2fb-8ec1-44c4-b6d0-23afbe2f6a1c",
  "source_account_id": "95b31a55-7fba-47f6-b452-c6f2e7c53bde",
  "target_account_id": "b2714527-9812-490b-a3e9-c70f9cd9663c",
  "amount": 12000,
  "reference": "Move funds"
}

Response:

 




















HTTP 200 OK

{
  "id": "27e0e678-4f04-4ae4-85d9-a5bc91be5472",
  "type": "bank-transfer",
  "amount": 12000,
  "currency": "EUR",
  "status": "pending",
  "account_id": "95b31a55-7fba-47f6-b452-c6f2e7c53bde",
  "reference": "Move funds",
  "counterparty": {
    "name": "Sigmund Fleud",
    "account_id": "b2714527-9812-490b-a3e9-c70f9cd9663c",
    "account_details": {
      "type": "sepa",
      "iban": "SE0097700000000000000002"
    }
  },
  "created_at": "2021-05-11T09:55:17.000Z"
}

# External bank payment

There are two main ways to make a payment to another account:

  • using Intergiro account ID
  • via bank details

WARNING

Making payments online requires individual's Strong Customer Authentication.

# Make payment using counterparty account ID

This is the best way to move funds to somebody else's Intergiro account.

Example make payment via account ID request:

 










 




POST /v3/transactions/pay

Content-Type: application/json
Authorization: Bearer <access_token>

{
  "request_id": "9b68d2fb-8ec1-44c4-b6d0-23afbe2f6a1c",
  "account_id": "95b31a55-7fba-47f6-b452-c6f2e7c53bde",
  "counterparty": {
    "name": "Kraken LTD",
    "account_id": "220ce017-b261-4126-8bd9-addc8eb5b666"
  },
  "amount": 12000,
  "reference": "Invoice payment 1301"
}

Response:

 




















HTTP 200 OK

{
  "id": "27e0e678-4f04-4ae4-85d9-a5bc91be5472",
  "type": "bank-transfer",
  "amount": 12000,
  "currency": "EUR",
  "status": "pending",
  "account_id": "95b31a55-7fba-47f6-b452-c6f2e7c53bde",
  "reference": "Invoice payment 1301",
  "counterparty": {
    "name": "Kraken LTD",
    "account_id": "220ce017-b261-4126-8bd9-addc8eb5b666",
    "account_details": {
      "type": "sepa",
      "iban": "SE0097700000000000000002"
    }
  },
  "created_at": "2021-05-11T09:55:17.000Z"
}

# Make payment using account bank details

Example SEPA payment request:

 











 
 





POST /v3/transactions/pay

Content-Type: application/json
Authorization: Bearer <access_token>

{
  "request_id": "9b68d2fb-8ec1-44c4-b6d0-23afbe2f6a1c",
  "account_id": "95b31a55-7fba-47f6-b452-c6f2e7c53bde",
  "counterparty": {
    "name": "Kraken LTD",
    "account": {
      "iban": "DE75512108001245126199",
      "bic": "SOGEDEFF"
    }
  },
  "amount": 12000,
  "reference": "Invoice payment 1301"
}

Response:

 












HTTP 412 Precondition Failed

{
  "consent": {
    "id": "e1dd9cd7-1650-42b3-8496-a970fb40ed3f",
    "status": "pending"
    "scope": [
      "make_payment"
    ],
    "expires_at": "2021-05-11T09:55:17.000Z",
  }
}

← Card programmes →