GET
/
v2.01
/
{ClientId}
/
users
/
{UserId}
/
deposit-preauthorizations
[
    {
        "Id": "748bfd3c-96f0-4475-949b-3aedfa3bdcfc",
        "CreationDate": 1696255231,
        "ExpirationDate": 1698847231,
        "AuthorizationDate": 1696255242,
        "AuthorId": "204068024",
        "DebitedFunds": {
            "Currency": "EUR",
            "Amount": 22220
        },
        "Status": "SUCCEEDED",
        "PaymentStatus": "CANCELED",
        "PayinsLinked": {
            "PayinCaptureId": null,
            "PayinComplementId": null
        },
        "ResultCode": "000000",
        "ResultMessage": "Success",
        "CardId": "204068248",
        "PreferredCardNetwork": null,
        "SecureModeReturnURL": null,
        "SecureModeRedirectURL": null,
        "SecureModeNeeded": null,
        "PaymentType": "CARD",
        "ExecutionType": "DIRECT",
        "StatementDescriptor": null,
        "Culture": null,
        "BrowserInfo": null,
        "IpAddress": null,
        "Billing": null,
        "Shipping": null,
        "Requested3DSVersion": null,
        "Applied3DSVersion": null,
        "Tag": "Created using Mangopay API Postman Collection",
        "CardInfo": {
            "BIN": "497010",
            "IssuingBank": "LA BANQUE POSTALE",
            "IssuerCountryCode": "MA",
            "Type": "CREDIT",
            "Brand": "VISA",
            "SubType": null
        }
    }
]  

Query parameters

ResultCode
string

The code indicating the result of the operation. You can filter on multiple values by separating them with a comma.

Status
string

Allowed values: CREATED, SUCCEEDED, FAILED

The status of the transaction. You can filter on multiple values by separating them with a comma.

PaymentStatus
string
required

Allowed values: WAITING, CANCELED, CANCEL_REQUESTED, EXPIRED, TO_BE_COMPLETED, NO_SHOW_REQUESTED, NO_SHOW, VALIDATED, FAILED

The payment status of the deposit preauthorization object:

  • WAITING – The deposit preauthorization can be used: the preauthorized funds can be captured (without or prior to complement); a no-show can be declared; or the preauthorization can be canceled manually.
  • CANCELED – Value to pass to manually cancel the deposit preauthorization before use (whether for capture or no-show); indicates that the deposit preauthorization was canceled manually.
  • CANCEL_REQUESTED – The cancellation of the deposit preauthorization has been requested but not yet processed.
  • EXPIRED – The hold period on the preauthorized funds has ended without it being used (whether for capture or no-show).
  • TO_BE_COMPLETED – The preauthorized funds were captured (prior to complement) but the complement has not yet been captured.
  • NO_SHOW_REQUESTED – Value to pass to request a no-show, signaling no capture of the preauthorized funds but the intent to capture a complement.
  • NO_SHOW – A no-show was requested but a complement not yet been captured.
  • VALIDATED – Indicates either (i) that the preauthorized funds were captured without complement; (ii) that the preauthorized funds and a complement were captured; or (iii) that a no-show was declared and a complement was captured.
  • FAILED – The action against the preauthorization has failed (whether capture without complement, capture prior to complement, no-show request, complement), but a retry may be possible.

Responses

[
    {
        "Id": "748bfd3c-96f0-4475-949b-3aedfa3bdcfc",
        "CreationDate": 1696255231,
        "ExpirationDate": 1698847231,
        "AuthorizationDate": 1696255242,
        "AuthorId": "204068024",
        "DebitedFunds": {
            "Currency": "EUR",
            "Amount": 22220
        },
        "Status": "SUCCEEDED",
        "PaymentStatus": "CANCELED",
        "PayinsLinked": {
            "PayinCaptureId": null,
            "PayinComplementId": null
        },
        "ResultCode": "000000",
        "ResultMessage": "Success",
        "CardId": "204068248",
        "PreferredCardNetwork": null,
        "SecureModeReturnURL": null,
        "SecureModeRedirectURL": null,
        "SecureModeNeeded": null,
        "PaymentType": "CARD",
        "ExecutionType": "DIRECT",
        "StatementDescriptor": null,
        "Culture": null,
        "BrowserInfo": null,
        "IpAddress": null,
        "Billing": null,
        "Shipping": null,
        "Requested3DSVersion": null,
        "Applied3DSVersion": null,
        "Tag": "Created using Mangopay API Postman Collection",
        "CardInfo": {
            "BIN": "497010",
            "IssuingBank": "LA BANQUE POSTALE",
            "IssuerCountryCode": "MA",
            "Type": "CREDIT",
            "Brand": "VISA",
            "SubType": null
        }
    }
]