Create Bulk Invoices

1min
Bulk invoices API allows you to perform multiple create operations in a single HTTP request. It’s limited to 50 invoice objects and each object should be valid otherwise, if one invoice fails all fail and will not be created.
POST
Params
Body Parameters
invoices
required
Array
It accepts array of up to 50 invoice objects.
Curl
curl -X POST https://api.moyasar.com/v1/invoices/bulk \
     -u sk_test_MrtwozLJAuFmLKWWSaRaoaLX: \
     -H "Content-Type: application/json" \
     -d '{"invoices":
            [{"amount": "60000", "currency": "SAR", "description": "Sample Invoice #100"},
             {"amount": "8000", "currency": "SAR", "description": "Sample Invoice #101", "callback_url": "https://www.example.com/store/invoice.jsp"},
             {"amount": "92000", "currency": "SAR", "description": "Sample Invoice #102"}
            ]}'
curl -X POST https://api.moyasar.com/v1/invoices/bulk \
     -u sk_test_MrtwozLJAuFmLKWWSaRaoaLX: \
     -H "Content-Type: application/json" \
     -d '{"invoices":
            [{"amount": "60000", "currency": "SAR", "description": "Sample Invoice #100"},
             {"amount": "8000", "currency": "SAR", "description": "Sample Invoice #101", "callback_url": "https://www.example.com/store/invoice.jsp"},
             {"amount": "92000", "currency": "SAR", "description": "Sample Invoice #102"}
            ]}'
Responses
201
404
{
  "invoices": [
    {
      "id": "8d5d7ceb-17d9-4731-90cd-b095e5e9e3cb",
      "status": "initiated",
      "amount": 60000,
      "currency": "SAR",
      "description": "Sample Invoice #100",
      "logo_url": "https://s3-eu-west-1.amazonaws.com/moyasar.api.assets.prod/entities/logos/default.png",
      "amount_format": "600.00 SAR",
      "url": "https://checkout.moyasar.com/invoices/8d5d7ceb-17d9-4731-90cd-b095e5e9e3cb?lang=en",
      "callback_url": null,
      "expired_at": null,
      "created_at": "2023-08-23T11:59:44.795Z",
      "updated_at": "2023-08-23T11:59:44.795Z",
      "back_url": null,
      "success_url": null,
      "metadata": null,
      "payments": []
    },
    {
      "id": "e3f4174c-ba92-4d2e-813e-53829acb955a",
      "status": "initiated",
      "amount": 8000,
      "currency": "SAR",
      "description": "Sample Invoice #101",
      "logo_url": "https://s3-eu-west-1.amazonaws.com/moyasar.api.assets.prod/entities/logos/default.png",
      "amount_format": "80.00 SAR",
      "url": "https://checkout.moyasar.com/invoices/e3f4174c-ba92-4d2e-813e-53829acb955a?lang=en",
      "callback_url": "https://www.example.com/store/invoice.jsp",
      "expired_at": null,
      "created_at": "2023-08-23T11:59:44.799Z",
      "updated_at": "2023-08-23T11:59:44.799Z",
      "back_url": null,
      "success_url": null,
      "metadata": null,
      "payments": []
    },
    {
      "id": "1c3fd158-12ea-4693-91bb-dfe143e96164",
      "status": "initiated",
      "amount": 92000,
      "currency": "SAR",
      "description": "Sample Invoice #102",
      "logo_url": "https://s3-eu-west-1.amazonaws.com/moyasar.api.assets.prod/entities/logos/default.png",
      "amount_format": "920.00 SAR",
      "url": "https://checkout.moyasar.com/invoices/1c3fd158-12ea-4693-91bb-dfe143e96164?lang=en",
      "callback_url": null,
      "expired_at": null,
      "created_at": "2023-08-23T11:59:44.801Z",
      "updated_at": "2023-08-23T11:59:44.801Z",
      "back_url": null,
      "success_url": null,
      "metadata": null,
      "payments": []
    }
  ]
}

{
  "invoices": [
    {
      "id": "8d5d7ceb-17d9-4731-90cd-b095e5e9e3cb",
      "status": "initiated",
      "amount": 60000,
      "currency": "SAR",
      "description": "Sample Invoice #100",
      "logo_url": "https://s3-eu-west-1.amazonaws.com/moyasar.api.assets.prod/entities/logos/default.png",
      "amount_format": "600.00 SAR",
      "url": "https://checkout.moyasar.com/invoices/8d5d7ceb-17d9-4731-90cd-b095e5e9e3cb?lang=en",
      "callback_url": null,
      "expired_at": null,
      "created_at": "2023-08-23T11:59:44.795Z",
      "updated_at": "2023-08-23T11:59:44.795Z",
      "back_url": null,
      "success_url": null,
      "metadata": null,
      "payments": []
    },
    {
      "id": "e3f4174c-ba92-4d2e-813e-53829acb955a",
      "status": "initiated",
      "amount": 8000,
      "currency": "SAR",
      "description": "Sample Invoice #101",
      "logo_url": "https://s3-eu-west-1.amazonaws.com/moyasar.api.assets.prod/entities/logos/default.png",
      "amount_format": "80.00 SAR",
      "url": "https://checkout.moyasar.com/invoices/e3f4174c-ba92-4d2e-813e-53829acb955a?lang=en",
      "callback_url": "https://www.example.com/store/invoice.jsp",
      "expired_at": null,
      "created_at": "2023-08-23T11:59:44.799Z",
      "updated_at": "2023-08-23T11:59:44.799Z",
      "back_url": null,
      "success_url": null,
      "metadata": null,
      "payments": []
    },
    {
      "id": "1c3fd158-12ea-4693-91bb-dfe143e96164",
      "status": "initiated",
      "amount": 92000,
      "currency": "SAR",
      "description": "Sample Invoice #102",
      "logo_url": "https://s3-eu-west-1.amazonaws.com/moyasar.api.assets.prod/entities/logos/default.png",
      "amount_format": "920.00 SAR",
      "url": "https://checkout.moyasar.com/invoices/1c3fd158-12ea-4693-91bb-dfe143e96164?lang=en",
      "callback_url": null,
      "expired_at": null,
      "created_at": "2023-08-23T11:59:44.801Z",
      "updated_at": "2023-08-23T11:59:44.801Z",
      "back_url": null,
      "success_url": null,
      "metadata": null,
      "payments": []
    }
  ]
}
﻿
Updated 23 Nov 2023
Did this page help you?
Cancel Invoice
Invoice Notifications
Docs powered by Archbee
TABLE OF CONTENTS
POST
Create Bulk invoices