Insert Cart

https://api.test.netgiro.is/v1/checkout/InsertCart

Request body

Name Required Description
Amount Yes Total amount of the purchase
Reference Yes Reference
CustomerId* Yes SSN, SMS code, AppCode or GSM number for client identification
ConfirmationType** Yes Provider’s way of confirming purchases after customer confirmation
CallbackUrl*** No Url to which a POST request will be made after customer has confirmed the sale
CallbackCancelUrl*** No Url to which a POST request will be made after customer has cancelled the sale
Description No Purchase description
CartItemRequests No Cart items

*SSN for testing is 1111111119, GSM for testing is 8223281, AppCode can be generated here at the bottom of page

**Confirmation type values: 0 - automatic, 1 - server callback, 2 - manual

***If you provide CallbackUrl on InsertCart:

  • Callbacks are sent as POST requests (to the given URL) and will be considered acknowledged only if they respond with 200 OK.
  • Callback on CallbackUrl will be received when customer confirms payment request in mobile app
  • If provided, callback on CallbackCancelUrl will be received when customer cancels the cart. You can also use CheckCart to check the cart status.

Response body

Name Values
Success true, false
ResultCode see ResultCodes section
TransactionId GUID (cart identifier used later for checking or canceling cart)
ProcessCartCheckIntervalMiliseconds int? (The pace how often the cart should be checked by provider)

Possible responses for InsertCart

  • Successful insert
    • Success = true
    • ResultCode = Success (200)
    • TransactionId = GUID
  • Not a customer or any other validation error
    • Success = false
    • ResultCode = GenericError (400) or any other error code

After you create cart with CustomerId = 8223281 (GSM number as CustomerId) you can simulate customer confirmation or rejection (as in mobile app) on https://customer.test.netgiro.is/. See explanation here.


© 2024 Netgíró Greiðslumiðlun. - Kt: 5101222830 | Katrínartún 2, 105 Reykjavík | Sími: 4 300 330 | netgiro@netgiro.is