logo

Openbanking

MyBank

Get Started

Letter Of Guarantee flow

When the Developer wants to test the Letter of Guarantee APIs, they would need to create an app in their Dashboard of the API product type KSA LOG.

  1. Customer consents the LGSP that he/she would like to share his/her bank information & chooses the bank.
  2. Developer (LGSP) contacts the bank & sends Letter Guarantee Consent Request.
    • Bank checks if Developer App Id (client_id) has necessary authorizations
    • Bank uses the information & creates consent resource & initializes to
      AwaitingAuthorization
      status
  3. Bank responds to the Developer with the Consent Response, which also instructs the Developer on how to proceed with the Authentication & Authorization.
  4. The Developer redirects the bank customer to bank website for authentication (in Redirect method) & consent confirmation.
  5. After the necessary checks, the bank sends the Access Token to the Developer, Developer can submit the letter of guarantee request to the Bank.

Illustrative Flow for Letter of Gurantee

  • Step 1: Third party onboarding
  • Step 2: Third party App Creation
  • Step 3: Third Party token generation
  • Step 4: Create a letter-of-guarantee-consent
  • Step 5: ConsentID generated with "AwaitingAuthorization" status
  • Step 6: Customer authentication
  • Step 7: Customer authorization
  • Step 8: Consent updated to "Authorized" status
  • Step 9: Customer token granted
  • Step 10: Letter of Guarantee API with customer token
  • Step 11: Letter of Guarantee details response

LGSP Dev Portal Testing

The following steps are needed to complete the LGSP flow:

1. Select App

On clicking the

Test
button against the App as shown below, the Developer is redirected to the Swagger UI.

2. Developer Token Generation

The first step is to configure the Private Key using the

Click Here
Button. This can be also be reconfigured, if required.

Please chose the respective private key to sign the request ( which matches Certificate or JWKS url provided during the [App creation]) & paste it in the application signing private key field above the Authorize button.
Private-Key for Client Certificate
-----BEGIN PRIVATE KEY-----
MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQDaGj3mL+E3Mflz
oQ8iXkPFoW76OMA81+E6JxYr+wfWuHFTG5HeAH/6fujz3LNRz4t6ib8I3p11aDhC
ABfKPgoGspG+uoQQfbUTseYcSg9XcgQ4asNTYvSlribDTLH2bi7LZLfTIpIsOA7o
JMIXwQu+zSs/dOWAtr8abiV+aweEFCzoR53lz/Hkz4gukv7/JbyuRiN1tbsRwnTz
sDdpN47G61j6eYHiAAtirGSuA0MXbHolztOPyB6hJFelbg52TY5z1zYWQL1KCoXU
ubq5LpZwXhngmzT+LN+giYTHEDB3AIMibwjcIt8M6BIHtH37inyXZYHhTnXwH4YG
UtnDLtOPAgMBAAECggEAdHKUYAVqWtzs0gbJHNF1n9w8c46/XPzqPPFHjj3eho89
umC69ewQaH9AA4vvlhuY3dkTzTmGmnwFpX+FNC8BjWfkFxBgmKl1d8mBEdOc81Rl
2nVuSmRIOPmNqrKVRfy4MVJaL3mCz+cyVlHh62rfyYSjtaLFMn7f882haSjd/28F
HpfwJvrVcb2zEtbWdOBMH09fBSLqF7SuIGrawldyfdqbwZeqGuFxgDR8+675V65/
cEgIj8m5YcwnfFPptLNB8bcOcAFdQh1IQcJRnHw0DOrD8DvKs22VjnFpC+i7VoWS
GORahAUI7oZRayJhswq+DKHDXAr/bYMxU7oT0brFwQKBgQD/hdmgOyS7pFZPUcTy
GCl/zGYFLyFYHGLqCcHcvIIZBRqTuO6k6uD2f+zpQlcYeGYToBvgLJF66ja3ipee
XO0eTipwRcZuKh2SX6hYmj8f1HGNMi/WeHkfJoQhNVMw0hudxhh8gWwmsRr+LPyj
iXSoufzt3vVN52yFnMbhJ/0V4QKBgQDagoDYtLxm3RM086WIA3YtJ8repK4/XjzM
pDrm5vVpbVmBVqz+ypG6/punSX3gfS58IOaW4hw6FlWdhqkQEeg8bewKs/QXkc4a
c8EMj0ioeaYtJ3XF9sV8gl55bXshHR0yVoh2puDatDNUJyEzM8jtPA8jWVPbJQe7
N3FUNp83bwKBgErv4kcPkVJGe9l/TZcCZwlH1JOoosrIaGniuqwVzMGxsX2pOrO6
/obMNZqjDg/rH2SaDBLOf0vg7HMffh+/ePruSZvrmqosR8fpreFuOx0GnNaf5U+s
vTjZft6OWPt0Ywz+T6gT/LfMMPJiFyWO5lulT/wi6yYRvM3ikKDvrVWBAoGAROxl
N/XKd6fEJy+zRvPQku26UAAh9lsDUol7CtpPDrIvSVzNtJCw5wrojhvgWK8juoOm
OHGZ9biVyNpw+WCsoGML0VRx6f1TxYQ9oHiRspKsmBGaVJdCM8PriOG/tPI6A2bI
JKT+x/2PMzwkfMIY3rvTCpNin/1OMv+J/8Y68oECgYAS8AHgjWdTK321VUuxcJqT
NtPED5+5xwy2ZGSmbNVPfCGSsOceVGY4KdwO+qk6eXfcR/AS+tYnBJ0Cv5+JMGFa
cvZUH5a4ww4VocInEt01QzGdJd2JsqXn+mBsMepsajTvibCFKAapYTsw0QWaS6E6
eXYx8a1jK15SFaJ33Y4tZg==
-----END PRIVATE KEY-----
Private-Key for JWKS url
-----BEGIN RSA PRIVATE KEY-----
MIIEpQIBAAKCAQEA0J5vAPXfZS755gaBYn2PEakdHLtAmZc0cKA5wTL89V4uz9sd
kiub+S91cJUTqfxqFFwFe+acTKW7+HKOusJREq3oWNyv394+2OXSDz15Lso6GEAT
orSRTWzfqUjogjOOBxrvxrcMyxS2RM/NjaNPw2PDWO6u0/BHPWbzyKdKbzzGsuqp
d4bZ85+xzDXhXRe0n23GCnGxpPM0SvsW9CAme23+ET/F6VdfPKkX0GSU/vxdwEwG
Urk5sbBmtoLcj+pfpJKaA7ZbtLsngrIVIPRNUdcP3eCPiYHrDltsi1wnWlnRj2OB
cqfM6bVOQfIiVLv+UC2PgY9gmzzw+Q86GPBQOwIDAQABAoIBAQCsJhDzefEeTeVp
K3UZEQM+T472Zo6oL13WkmEWTDzxPQbj/qwoMlRDDCadAGd5nhDrPARKecIAfcLf
AalF85NzFo7kxTdcRMkXso3khZW6RqYp3LZXTSmZ+n2V89PpnSFWO6QhFmw4KJ8/
qTq15k2rrmdEu7EIsv4WbR4+Nc32e3L9PRcHM14ez3rXPEt9z9BAUwnjqmm4uXmc
GmYwSs2EHC1jfTLWzpxdYCEQNG959jKE4/JIKNuZRZJ6XuzC4bFkpAhiQlLVAn6D
97gPJWDJuxjSZtovbA2dlhb+uRUS2Ygj0vi0Z/NxgFh3vTzg5e9OWHxhW4l+DGoK
shiU5BABAoGBAOw3B2wahVxulE8V+p3yOCiEsoSoQIXuOx90IwUWTdNxBUdPi6ce
p3GOZIjDMf/Hjz85Tv1PCJxuj84QIGRXbaiWLdpXFC+dB53z1r9SqBhXvGwjae4m
Epik/9EoxU8wWZ5qAKBXGxAM1x4IFjJ2zK6UiwRB+uHRdhqoF11VxhHbAoGBAOIX
rwjuYHFQuEDmcaGqXYLwdAMEohxmRLgIIa2JXf+oDZeNsjJjrKgYUeV4Ckp4FL9r
6zPTZBl3FEVWK3LpCyk920uchqeW18zIxKHQ4ozqN9zsc/7lrXFEh+SaQewaVEtl
LqKpySQNGJy4/71u4x3M3d9//zyfQkEmuUkwPvkhAoGBAJRLl+VOYRs+cO2Vptky
D/+gD1MpLhjnD0cX6kRvVDzCX8X9Mnegzw6DjqotoV4rMstGd0igLY/H+ZAsn6lf
GgEVB4Rj1tBtjTKkutUyV0WxDyH0ubRBQruCGvh82CJ3AExr0CjZhqv047h+6zCT
VLzllMD/iznp/nONw91c1BSxAoGAXSY21i4oC+ee0hZfcKTZPA5HLcsl4x97Znrr
LS0wThl16B/X8AzC4MqMS0dmrgHFQox67fJFBnzaHCsBYamEEKzMgd1uWPO720JI
SQbfoAELnPjKXZVRHR6IAnZPfK/oVNvOF/Rty22d20wZCXn7FpcGPoPkq5xN1rvW
kMHQ4CECgYEA5d84bsBKb6u0YspU9hpc9o8F5PcJxqlwsfyOof80tUwA3NTk985c
vaiXM5kQwM21q7bCyMoNfTi681MzlK1gt9GYRAHV4NJhw410mGDdnmGYFtsJwJIZ
bnwttYJsI0RIrk7Irom8HD2AnTvV5aI05Dxhv/+nCfn+bhy1Qqwce98=
-----END RSA PRIVATE KEY---

The next step is AISP's App-Id to get authenticated by clicking the

ThirdParty Authorise
button & fill in the App secret to get access token specific to the Developer.

The bearer token from the above step should be populated in the LGSP Consent Endpoint.

Use the below payload to send a request.

{
  "aud": "KSAOBKSA-ETC-QLNU",
  "nbf": 1701952096,
  "iss": "KSAOBKSA-ETC-QLNU",
  "exp": 1701952996,
  "message": {
    "Data": {
      "AuthExpirationDateTime": "2025-02-17T05:49:05.522Z",
      "Mt798": {
        "CustomerReferenceNumber": "SNBAN090",
        "MessageCreationDateTime": "2025-01-16T05:49:05.522Z",
        "KindOfGuarantee": "GUAR",
        "TypeOfGuarantee": "TEND",
        "FormOfGuarantee": "DIRC",
        "WordingOfGuarantee": "STND",
        "SpecialTerms": "EFCT",
        "LanguageOfStandardWording": "en",
        "ProjectName": "Mandersons Construction",
        "ProjectNumber": "01110",
        "Applicant": {
          "Name": "Banfico",
          "CommercialRegistrationNumber": 81945678,
          "ApplicantIdentifierType": "AZ1234567",
          "ApplicantNumber": "2613",
          "Address": {
            "AddressType": "KSAOB.Business",
            "ShortAddress": "BAN12325",
            "BuildingNumber": "3201",
            "UnitNumber": 5,
            "StreetName": "King Fahad Roar",
            "SecondaryNumber": "3254",
            "District": "al Nakheel",
            "PostalCode": "14442",
            "City": "Riyadh",
            "Country": "SA"
          }
        },
        "GuaranteeAmount": {
          "Type": "PRIN",
          "Amount": "141423.20562",
          "Currency": "SAR"
        },
        "ValidityType": "LIMT",
        "ValidityExpiryDate": "2025-02-17T05:49:05.522Z",
        "DeliveryOfOriginalGuarantee": "COUR",
        "DeliveryTo": "BENE",
        "DeliveryAddress": {
          "Name": "Manderson Constructions",
          "Address": {
            "AddressType": "KSAOB.Business",
            "ShortAddress": "MAN567",
            "BuildingNumber": "03/1",
            "UnitNumber": 9,
            "StreetName": "King Fahad Road",
            "SecondaryNumber": "1226",
            "District": "al Nakheel",
            "PostalCode": "14442",
            "City": "Riyadh",
            "Country": "SA"
          }
        },
        "Beneficiary": {
          "Name": "Manderson Constructions",
          "CommercialRegistrationNumber": 678365,
          "BeneficiaryIdentifierType": "Customer Parent",
          "BeneficiaryNumber": "02220",
          "Address": {
            "AddressType": "KSAOB.Business",
            "ShortAddress": "MAN567",
            "BuildingNumber": "03/1",
            "UnitNumber": 9,
            "StreetName": "King Fahad Road",
            "SecondaryNumber": "1226",
            "District": "al Nakheel",
            "PostalCode": "14442",
            "City": "Riyadh",
            "Country": "SA"
          }
        },
        "LiabilityDetails": "Pumps and Equipment",
        "Reference": "TEND",
        "ReferenceDate1": "2023-01-16T05:49:05.522Z",
        "ReferenceDate2": "2023-01-16T05:49:05.522Z",
        "TotalOrderAmount": {
          "Amount": "28246087.2",
          "Currency": "SAR"
        },
        "GuaranteeValueInPercent": 10,
        "CustomerContact": "John Doe",
        "BeneficiaryContact": "Jane Bloggs",
        "BankReferenceNumber": "string",
        "TransactionReferenceNumber": "NONREF",
        "FurtherIdentification": "ISSUE",
        "ApplicableRules": "NONE",
        "ChargesAndFees": "10%",
        "DetailsOfGuarantee": "Performance Guarantee No . PGFFA0815.We have been informed that you, Mining PLC, Main Road, Riyadh, hereinafter called the BUYER have concluded the contract No. ABC123 of 05th February 2022, hereinafter called the CONTRACT, with Pumps Riyadh, KSA, hereinafter called the SELLER, according to which the SELLER will deliver to the BUYER pumps and equipment, in the total value of SAR 500.000,00. As agreed the SELLER has to provide a bank guarantee in favour of the BUYER, amounting to 10 percent of the total value, i.e. SAR 50.000,00 , to cover the fulfilment of the SELLER's obligations under the CONTRACT.In consideration of the aforesaid, we, Bank of Acme, Riyadh, hereby issue the guarantee on behalf of the SELLER towards the BUYER to the maximum amount of SAR 50.000,00 (in words: SAR fifty thousand 00/100) and undertake irrevocably without consideration of any objections and defences of the SELLER or third parties and irrespective of the validity and legal effect of the CONTRACT and waiving any objections arising there from to pay to the BUYER any amount claimed from us by the BUYER up to the maximum amount of this guarantee upon receipt of the BUYER's first demand in writing, in which the BUYER simultaneously confirms that the SELLER is in breach of its obligations towards the BUYER under the CONTRACT.The obligation under this guarantee shall expire on 31st December 2022.Any claim for payment complying with the above conditions must be received by us within the validity period of this guarantee. This guarantee shall be governed by the law of KSA. Exclusive place of jurisdiction shall be KSA, Saudi Arabia.",
        "TermsAndConditions": "As defined in Open Bnking License SAMA intends to make the KSA Standards available to all the Contributors and to facilitate it to all contributores who provides feedback, comments or reviews the standard is considered as a Legal Entity",
        "LetterOfGuaranteeStartDate": "2023-01-16T05:49:05.522Z"
      }
    },
    "Subscription": {
      "Webhook": {
        "Url": "https://webhook.site/b6774b15-c7a5-49df-87ed-6b6ca279d1a2",
        "IsActive": false
      }
    }
  }
}
  • On a successful request the Developer will receive the below response.
  • Please verify that an unique 'ConsentID' will be generated and the status of the 'ConsentID' will be set as
    AwaitingAuthorization
    .
{
  "aud": "KSAOBKSA-CDE-FMYJ",
  "nbf": 1702012483,
  "iss": "KSAOBKSA-CDE-FMYJ",
  "exp": 1702013383,
  "message": {
    "Data": {
      "ConsentId": "lg-173f3932-08b9-4b44-8bca-ac0aa6cae96b",
      "CreationDateTime": "2023-12-08T05:14:43.306902Z",
      "Status": "AwaitingAuthorization",
      "StatusUpdateDateTime": "2023-12-08T05:14:43.306947Z",
      "AuthExpirationDateTime": "2025-02-17T05:49:05.522Z",
      "Mt798": {
        "CustomerReferenceNumber": "SNBAN090",
        "MessageCreationDateTime": "2025-01-16T05:49:05.522Z",
        "KindOfGuarantee": "GUAR",
        "TypeOfGuarantee": "TEND",
        "FormOfGuarantee": "DIRC",
        "WordingOfGuarantee": "STND",
        "SpecialTerms": "EFCT",
        "LanguageOfStandardWording": "en",
        "ProjectName": "Mandersons Construction",
        "ProjectNumber": "01110",
        "Applicant": {
          "Name": "Banfico",
          "CommercialRegistrationNumber": 81945678,
          "ApplicantIdentifierType": "AZ1234567",
          "ApplicantNumber": "2613",
          "Address": {
            "AddressType": "KSAOB.Business",
            "ShortAddress": "BAN12325",
            "BuildingNumber": "3201",
            "UnitNumber": 5,
            "StreetName": "King Fahad Roar",
            "SecondaryNumber": "3254",
            "District": "al Nakheel",
            "PostalCode": "14442",
            "City": "Riyadh",
            "Country": "SA"
          }
        },
        "GuaranteeAmount": {
          "Type": "PRIN",
          "Amount": "141423.20562",
          "Currency": "SAR"
        },
        "ValidityType": "LIMT",
        "ValidityExpiryDate": "2025-02-17T05:49:05.522Z",
        "DeliveryOfOriginalGuarantee": "COUR",
        "DeliveryTo": "BENE",
        "DeliveryAddress": {
          "Name": "Manderson Constructions",
          "Address": {
            "AddressType": "KSAOB.Business",
            "ShortAddress": "MAN567",
            "BuildingNumber": "03/1",
            "UnitNumber": 9,
            "StreetName": "King Fahad Road",
            "SecondaryNumber": "1226",
            "District": "al Nakheel",
            "PostalCode": "14442",
            "City": "Riyadh",
            "Country": "SA"
          }
        },
        "Beneficiary": {
          "Name": "Manderson Constructions",
          "CommercialRegistrationNumber": 678365,
          "BeneficiaryIdentifierType": "Customer Parent",
          "BeneficiaryNumber": "02220",
          "Address": {
            "AddressType": "KSAOB.Business",
            "ShortAddress": "MAN567",
            "BuildingNumber": "03/1",
            "UnitNumber": 9,
            "StreetName": "King Fahad Road",
            "SecondaryNumber": "1226",
            "District": "al Nakheel",
            "PostalCode": "14442",
            "City": "Riyadh",
            "Country": "SA"
          }
        },
        "LiabilityDetails": "Pumps and Equipment",
        "Reference": "TEND",
        "ReferenceDate": null,
        "ReferenceDate1": "2023-01-16T05:49:05.522Z",
        "ReferenceDate2": "2023-01-16T05:49:05.522Z",
        "TotalOrderAmount": {
          "Amount": "28246087.2",
          "Currency": "SAR"
        },
        "GuaranteeValueInPercent": 10,
        "CustomerContact": "John Doe",
        "BeneficiaryContact": "Jane Bloggs",
        "BankReferenceNumber": "string",
        "TransactionReferenceNumber": "NONREF",
        "FurtherIdentification": "ISSUE",
        "ApplicableRules": "NONE",
        "ChargesAndFees": "10%",
        "DetailsOfGuarantee": "Performance Guarantee No . PGFFA0815.We have been informed that you, Mining PLC, Main Road, Riyadh, hereinafter called the BUYER have concluded the contract No. ABC123 of 05th February 2022, hereinafter called the CONTRACT, with Pumps Riyadh, KSA, hereinafter called the SELLER, according to which the SELLER will deliver to the BUYER pumps and equipment, in the total value of SAR 500.000,00. As agreed the SELLER has to provide a bank guarantee in favour of the BUYER, amounting to 10 percent of the total value, i.e. SAR 50.000,00 , to cover the fulfilment of the SELLER's obligations under the CONTRACT.In consideration of the aforesaid, we, Bank of Acme, Riyadh, hereby issue the guarantee on behalf of the SELLER towards the BUYER to the maximum amount of SAR 50.000,00 (in words: SAR fifty thousand 00/100) and undertake irrevocably without consideration of any objections and defences of the SELLER or third parties and irrespective of the validity and legal effect of the CONTRACT and waiving any objections arising there from to pay to the BUYER any amount claimed from us by the BUYER up to the maximum amount of this guarantee upon receipt of the BUYER's first demand in writing, in which the BUYER simultaneously confirms that the SELLER is in breach of its obligations towards the BUYER under the CONTRACT.The obligation under this guarantee shall expire on 31st December 2022.Any claim for payment complying with the above conditions must be received by us within the validity period of this guarantee. This guarantee shall be governed by the law of KSA. Exclusive place of jurisdiction shall be KSA, Saudi Arabia.",
        "TermsAndConditions": "As defined in Open Bnking License SAMA intends to make the KSA Standards available to all the Contributors and to facilitate it to all contributores who provides feedback, comments or reviews the standard is considered as a Legal Entity",
        "LetterOfGuaranteeStartDate": "2023-01-16T05:49:05.522Z"
      }
    },
    "Links": null,
    "Meta": null,
    "Subscription": {
      "Webhook": {
        "Url": "https://webhook.site/b6774b15-c7a5-49df-87ed-6b6ca279d1a2",
        "IsActive": false
      }
    }
  },
  "iat": 1702012483
}

The response provides the ConsentId, Consent Status & scaOAuth endpoint. The Developer uses this well-known endpoint URI of the bank to redirect the user to the bank for authentication.

4. PSU Authentication

Select the

Customer Authorise
to authenticate the PSU.

Two types of PSU Authentication flows are supported:

  1. Redirect Authorize
  2. Decoupled Authorize

To navigate through PSU authentication flow and generate PSU Token please refer PSU Authentication flow

5. Initiate the Letter of Guarantee

Now you need to initiate the letter of guarantee (authorization header is auto populated). Use below payload to initiate the letter of guarantee via POST /letters-of-guarantee.

{
    "aud": "KSAOBKSA-ETC-QLNU",
  "nbf": 1701952096,
  "iss": "KSAOBKSA-ETC-QLNU",
  "exp": 1701952996,
  "message": {
    "Data": {
      "ConsentId": "------Consent_Id------"
    }
  }
}
  • On a successful request the Developer will receive the below response.
  • Please verify that an unique 'LetterOfGuaranteeID' will be generated and the status of the 'LetterOfGuaranteeID' will be set as
    Pending
    .
{
  "aud": "KSAOBKSA-CDE-FMYJ",
  "nbf": 1702012934,
  "iss": "KSAOBKSA-CDE-FMYJ",
  "exp": 1702013834,
  "message": {
    "Data": {
      "LetterOfGuaranteeId": "f5d944b5-a424-4e7f-98eb-4cf969a43ec3",
      "ConsentId": "lg-e14addbc-6cc6-4eaf-94d9-ed367c8d7ea0",
      "Status": "Pending",
      "StatusUpdateDateTime": "2023-12-08T05:22:14.102266Z",
      "Mt798": {
        "CustomerReferenceNumber": "SNBAN090",
        "MessageCreationDateTime": "2025-01-16T05:49:05.522Z",
        "KindOfGuarantee": "GUAR",
        "TypeOfGuarantee": "TEND",
        "FormOfGuarantee": "DIRC",
        "WordingOfGuarantee": "STND",
        "SpecialTerms": "EFCT",
        "LanguageOfStandardWording": "en",
        "ProjectName": "Mandersons Construction",
        "ProjectNumber": "01110",
        "Applicant": {
          "Name": "Banfico",
          "CommercialRegistrationNumber": 81945678,
          "ApplicantIdentifierType": "AZ1234567",
          "ApplicantNumber": "2613",
          "Address": {
            "AddressType": "KSAOB.Business",
            "ShortAddress": "BAN12325",
            "BuildingNumber": "3201",
            "UnitNumber": 5,
            "StreetName": "King Fahad Roar",
            "SecondaryNumber": "3254",
            "District": "al Nakheel",
            "PostalCode": "14442",
            "City": "Riyadh",
            "Country": "SA"
          }
        },
        "GuaranteeAmount": {
          "Type": "PRIN",
          "Amount": "141423.20562",
          "Currency": "SAR"
        },
        "ValidityType": "LIMT",
        "ValidityExpiryDate": "2025-02-17T05:49:05.522Z",
        "DeliveryOfOriginalGuarantee": "COUR",
        "DeliveryTo": "BENE",
        "DeliveryAddress": {
          "Name": "Manderson Constructions",
          "Address": {
            "AddressType": "KSAOB.Business",
            "ShortAddress": "MAN567",
            "BuildingNumber": "03/1",
            "UnitNumber": 9,
            "StreetName": "King Fahad Road",
            "SecondaryNumber": "1226",
            "District": "al Nakheel",
            "PostalCode": "14442",
            "City": "Riyadh",
            "Country": "SA"
          }
        },
        "Beneficiary": {
          "Name": "Manderson Constructions",
          "CommercialRegistrationNumber": 678365,
          "BeneficiaryIdentifierType": "Customer Parent",
          "BeneficiaryNumber": "02220",
          "Address": {
            "AddressType": "KSAOB.Business",
            "ShortAddress": "MAN567",
            "BuildingNumber": "03/1",
            "UnitNumber": 9,
            "StreetName": "King Fahad Road",
            "SecondaryNumber": "1226",
            "District": "al Nakheel",
            "PostalCode": "14442",
            "City": "Riyadh",
            "Country": "SA"
          }
        },
        "LiabilityDetails": "Pumps and Equipment",
        "Reference": "TEND",
        "ReferenceDate": null,
        "ReferenceDate1": "2023-01-16T05:49:05.522Z",
        "ReferenceDate2": "2023-01-16T05:49:05.522Z",
        "TotalOrderAmount": {
          "Amount": "28246087.2",
          "Currency": "SAR"
        },
        "GuaranteeValueInPercent": 10,
        "CustomerContact": "John Doe",
        "BeneficiaryContact": "Jane Bloggs",
        "BankReferenceNumber": "string",
        "TransactionReferenceNumber": "NONREF",
        "FurtherIdentification": "ISSUE",
        "ApplicableRules": "NONE",
        "ChargesAndFees": "10%",
        "DetailsOfGuarantee": "Performance Guarantee No . PGFFA0815.We have been informed that you, Mining PLC, Main Road, Riyadh, hereinafter called the BUYER have concluded the contract No. ABC123 of 05th February 2022, hereinafter called the CONTRACT, with Pumps Riyadh, KSA, hereinafter called the SELLER, according to which the SELLER will deliver to the BUYER pumps and equipment, in the total value of SAR 500.000,00. As agreed the SELLER has to provide a bank guarantee in favour of the BUYER, amounting to 10 percent of the total value, i.e. SAR 50.000,00 , to cover the fulfilment of the SELLER's obligations under the CONTRACT.In consideration of the aforesaid, we, Bank of Acme, Riyadh, hereby issue the guarantee on behalf of the SELLER towards the BUYER to the maximum amount of SAR 50.000,00 (in words: SAR fifty thousand 00/100) and undertake irrevocably without consideration of any objections and defences of the SELLER or third parties and irrespective of the validity and legal effect of the CONTRACT and waiving any objections arising there from to pay to the BUYER any amount claimed from us by the BUYER up to the maximum amount of this guarantee upon receipt of the BUYER's first demand in writing, in which the BUYER simultaneously confirms that the SELLER is in breach of its obligations towards the BUYER under the CONTRACT.The obligation under this guarantee shall expire on 31st December 2022.Any claim for payment complying with the above conditions must be received by us within the validity period of this guarantee. This guarantee shall be governed by the law of KSA. Exclusive place of jurisdiction shall be KSA, Saudi Arabia.",
        "TermsAndConditions": "As defined in Open Bnking License SAMA intends to make the KSA Standards available to all the Contributors and to facilitate it to all contributores who provides feedback, comments or reviews the standard is considered as a Legal Entity",
        "LetterOfGuaranteeStartDate": "2023-01-16T05:49:05.522Z"
      }
    },
    "Links": null,
    "Meta": null
  },
  "iat": 1702012934
}

After initiating the letter of guarantee you will be able to retrieve the letter of guarantee with more information. Try out ksaob-lgsp/v3.10/letters-of-guarantee/{letterOfGuaranteeId} API. A sample response will be like the below:

{
  "aud": "aud",
  "nbf": 1702012971,
  "iss": "iss",
  "exp": 1702013871,
  "message": {
    "Data": {
      "LetterOfGuaranteeId": "f5d944b5-a424-4e7f-98eb-4cf969a43ec3",
      "ConsentId": "lg-e14addbc-6cc6-4eaf-94d9-ed367c8d7ea0",
      "Status": "Pending",
      "StatusUpdateDateTime": "2023-12-08T05:22:14.102266Z",
      "Mt798": {
        "CustomerReferenceNumber": "SNBAN090",
        "MessageCreationDateTime": "2025-01-16T05:49:05.522Z",
        "KindOfGuarantee": "GUAR",
        "TypeOfGuarantee": "TEND",
        "FormOfGuarantee": "DIRC",
        "WordingOfGuarantee": "STND",
        "SpecialTerms": "EFCT",
        "LanguageOfStandardWording": "en",
        "ProjectName": "Mandersons Construction",
        "ProjectNumber": "01110",
        "Applicant": {
          "Name": "Banfico",
          "CommercialRegistrationNumber": 81945678,
          "ApplicantIdentifierType": "AZ1234567",
          "ApplicantNumber": "2613",
          "Address": {
            "AddressType": "KSAOB.Business",
            "ShortAddress": "BAN12325",
            "BuildingNumber": "3201",
            "UnitNumber": 5,
            "StreetName": "King Fahad Roar",
            "SecondaryNumber": "3254",
            "District": "al Nakheel",
            "PostalCode": "14442",
            "City": "Riyadh",
            "Country": "SA"
          }
        },
        "GuaranteeAmount": {
          "Type": "PRIN",
          "Amount": "141423.20562",
          "Currency": "SAR"
        },
        "ValidityType": "LIMT",
        "ValidityExpiryDate": "2025-02-17T05:49:05.522Z",
        "DeliveryOfOriginalGuarantee": "COUR",
        "DeliveryTo": "BENE",
        "DeliveryAddress": {
          "Name": "Manderson Constructions",
          "Address": {
            "AddressType": "KSAOB.Business",
            "ShortAddress": "MAN567",
            "BuildingNumber": "03/1",
            "UnitNumber": 9,
            "StreetName": "King Fahad Road",
            "SecondaryNumber": "1226",
            "District": "al Nakheel",
            "PostalCode": "14442",
            "City": "Riyadh",
            "Country": "SA"
          }
        },
        "Beneficiary": {
          "Name": "Manderson Constructions",
          "CommercialRegistrationNumber": 678365,
          "BeneficiaryIdentifierType": "Customer Parent",
          "BeneficiaryNumber": "02220",
          "Address": {
            "AddressType": "KSAOB.Business",
            "ShortAddress": "MAN567",
            "BuildingNumber": "03/1",
            "UnitNumber": 9,
            "StreetName": "King Fahad Road",
            "SecondaryNumber": "1226",
            "District": "al Nakheel",
            "PostalCode": "14442",
            "City": "Riyadh",
            "Country": "SA"
          }
        },
        "LiabilityDetails": "Pumps and Equipment",
        "Reference": "TEND",
        "ReferenceDate": null,
        "ReferenceDate1": "2023-01-16T05:49:05.522Z",
        "ReferenceDate2": "2023-01-16T05:49:05.522Z",
        "TotalOrderAmount": {
          "Amount": "28246087.2",
          "Currency": "SAR"
        },
        "GuaranteeValueInPercent": 10,
        "CustomerContact": "John Doe",
        "BeneficiaryContact": "Jane Bloggs",
        "BankReferenceNumber": "string",
        "TransactionReferenceNumber": "NONREF",
        "FurtherIdentification": "ISSUE",
        "ApplicableRules": "NONE",
        "ChargesAndFees": "10%",
        "DetailsOfGuarantee": "Performance Guarantee No . PGFFA0815.We have been informed that you, Mining PLC, Main Road, Riyadh, hereinafter called the BUYER have concluded the contract No. ABC123 of 05th February 2022, hereinafter called the CONTRACT, with Pumps Riyadh, KSA, hereinafter called the SELLER, according to which the SELLER will deliver to the BUYER pumps and equipment, in the total value of SAR 500.000,00. As agreed the SELLER has to provide a bank guarantee in favour of the BUYER, amounting to 10 percent of the total value, i.e. SAR 50.000,00 , to cover the fulfilment of the SELLER's obligations under the CONTRACT.In consideration of the aforesaid, we, Bank of Acme, Riyadh, hereby issue the guarantee on behalf of the SELLER towards the BUYER to the maximum amount of SAR 50.000,00 (in words: SAR fifty thousand 00/100) and undertake irrevocably without consideration of any objections and defences of the SELLER or third parties and irrespective of the validity and legal effect of the CONTRACT and waiving any objections arising there from to pay to the BUYER any amount claimed from us by the BUYER up to the maximum amount of this guarantee upon receipt of the BUYER's first demand in writing, in which the BUYER simultaneously confirms that the SELLER is in breach of its obligations towards the BUYER under the CONTRACT.The obligation under this guarantee shall expire on 31st December 2022.Any claim for payment complying with the above conditions must be received by us within the validity period of this guarantee. This guarantee shall be governed by the law of KSA. Exclusive place of jurisdiction shall be KSA, Saudi Arabia.",
        "TermsAndConditions": "As defined in Open Bnking License SAMA intends to make the KSA Standards available to all the Contributors and to facilitate it to all contributores who provides feedback, comments or reviews the standard is considered as a Legal Entity",
        "LetterOfGuaranteeStartDate": "2023-01-16T05:49:05.522Z"
      }
    },
    "Links": null,
    "Meta": null
  },
  "iat": 1702012971
}
logo

Openbanking

MyBank

Navigation
Developers
Legals