Skip to main content

DepositInformation

Deposit common information.

idstringrequired

Deposit id generated during creation.

Example: 112233
customerIdstringrequired

Customer id.

Example: 10001
accountIdstringrequired

The account where the money gets deposited in. It deduced based on the currency.

Example: 2100002
slipIdstring

Slip identifier. Slip contains list of transactions associated with the deposit operations.

Example: 5009964049
fundingTransactionIdstring

Deposit Funding transaction id. Stored by Single API and used for Recon.

Example: 500005
creationTimestring<date-time>required

Represents RFC 3339, section 5.6 date-time.

Example: 2021-07-15T17:54:12Z
expirationTimestring<date-time>

Represents RFC 3339, section 5.6 date-time.

Example: 2021-07-15T17:54:12Z
statusPayment Status (string)required

The payment status:

  • PREVIEW - Payment preview.
  • PENDING - Payment transaction is created and further action is required by the customer.
  • PROCESSING - Payment is scheduled for processing by the payment provider.
  • COMPLETED - Payment is completed. Note that some transactions might be completed from Embedded Wallet point of view, but not from customer point of view, since money movement might take some time outside of the Embedded Wallet network.
  • FAILED - Payment has failed. Check STATUS_REASON property for details.
  • CANCELLED - Payment have been cancelled
  • REFUNDED - Payment has been refunded. Valid only for deposits.
  • SCHEDULED - Payment is scheduled funds are blocked, but some action is required. Check action response object property for details
  • ACCEPTED - Payment has been accepted by the recipient and will be automatically processed.

Possible values: [PREVIEW, PENDING, PROCESSING, COMPLETED, FAILED, SCHEDULED, ACCEPTED, CANCELLED, REFUNDED]

Example: FAILED
statusReasonstring

Status reason for FAILED transaction.

Possible values: <= 60 characters

nextStatusPayment Status (string)[]

Provides the next possible status update the client can request, depending on the chosen payment type and option.

Possible values: [PREVIEW, PENDING, PROCESSING, COMPLETED, FAILED, SCHEDULED, ACCEPTED, CANCELLED, REFUNDED]

actionPayment Action (string)

Specifies action required to complete to be able to continue to the next payment status:

  • NONE – No action is required, you can proceed to the next deposit status.
  • REDIRECT – The user must be redirected in order to complete a payment, for example, when an alternate payment method like Paysafecard is used.
  • SCA - The user must complete a Strong Customer Authentication (SCA) process.
  • ONBOARD - A transfer-specific action is required. The recipient customer must be registered with the corresponding email address.
  • USER_INPUT - Additional information from the user is required to complete the payment.

Possible values: [NONE, REDIRECT, SCA, ONBOARD, USER_INPUT]

Default value: NONE
Example: NONE
redirectUrl object

The redirect link defines the link used to redirect the payment flow to hosted payment page. The property rel defines the link type semantic.

relRedirectLinkType (string)

The link rel defines the redirect link semantic.

  • REDIRECT_PAYMENT - Merchant needs to redirect consumer to this url to complete payment.

Possible values: [REDIRECT_PAYMENT]

Default value: REDIRECT_PAYMENT
Example: REDIRECT_PAYMENT
hrefstring

The url to be used for further actions.

Example: https://api.paysafe.com/card/redirect/372b5ee7-6360-4403-b444-164f8f1d2709
methodHttpRequestMethod (string)

HTTP request method.

Possible values: [GET, POST]

Example: GET
paymentOptionPaymentOptionType (string)

Enumeration of supported Payment Option Types

Possible values: [RAPID_TRANSFER, BANK_TRANSFER, OFFLINE_BANK_TRANSFER, CARD, PAYSAFECASH, PAYSAFECARD, PAGO_EFECTIVO, MBWAY, KLARNA]

Example: CARD
refundableboolean

Is the deposit refundable.

instrumentValidationRules object[]

List of payment instrument validation rules relevant for the specific payment option and allows client side instrument validation. This field is returned only when no existing payment instrument is passed, upon deposit creation. This field can also contain validation data for payment options, that does not use payment instruments.

  • Array [
    • instrumentTypeInstrumentType (string)

    Represents the type of the instrument.

    ValueDescription
    SEPA_BANK_ACCOUNTSEPA Bank account
    UK_BANK_ACCOUNTUK Bank account
    US_BANK_ACCOUNTUS Bank account
    CCI_BANK_ACCOUNTCCI Bank account
    CARDCard

    Possible values: [SEPA_BANK_ACCOUNT, UK_BANK_ACCOUNT, US_BANK_ACCOUNT, CCI_BANK_ACCOUNT, CARD]

    Example: CARD
    fields object[]
  • Array [
    • fieldNamestring

    Field name.

    Example: iban
    validations object[]
  • Array [
    • idstring

    Validation rule id. Can be used to identify the validation.

    Example: VALID_IBAN
    messagestring

    Human readable validation error message in English.

    Example: Please enter valid IBAN.
    regexpstring

    Regular explression for the validation

    Example: ^AL\d{10}[0-9A-Z]{16}$|^AD\d{10}[0-9A-Z]{12}$|^AT\d{18}$|^BH\d{2}[A-Z]{4}[0-9A-Z]{14}$|^BE\d{14}$|^BA\d{18}$|^BG\d{2}[A-Z]{4}\d{6}[0-9A-Z]{8}$|^HR\d{19}$|^CY\d{10}[0-9A-Z]{16}$|^CZ\d{22}$|^DK\d{16}$|^FO\d{16}$|^GL\d{16}$|^DO\d{2}[0-9A-Z]{4}\d{20}$|^EE\d{18}$|^FI\d{16}$|^FR\d{12}[0-9A-Z]{11}\d{2}$|^GE\d{2}[A-Z]{2}\d{16}$|^DE\d{20}$|^GI\d{2}[A-Z]{4}[0-9A-Z]{15}$|^GR\d{9}[0-9A-Z]{16}$|^HU\d{26}$|^IS\d{24}$|^IE\d{2}[A-Z]{4}\d{14}$|^IL\d{21}$|^IT\d{2}[A-Z]\d{10}[0-9A-Z]{12}$|^[A-Z]{2}\d{5}[0-9A-Z]{13}$|^KW\d{2}[A-Z]{4}22!$|^LV\d{2}[A-Z]{4}[0-9A-Z]{13}$|^LB\d{6}[0-9A-Z]{20}$|^LI\d{7}[0-9A-Z]{12}$|^LT\d{18}$|^LU\d{5}[0-9A-Z]{13}$|^MK\d{5}[0-9A-Z]{10}\d{2}$|^MT\d{2}[A-Z]{4}\d{5}[0-9A-Z]{18}$|^MR13\d{23}$|^MU\d{2}[A-Z]{4}\d{19}[A-Z]{3}$|^MC\d{12}[0-9A-Z]{11}\d{2}$|^ME\d{20}$|^NL\d{2}[A-Z]{4}\d{10}$|^NO\d{13}$|^PL\d{10}[0-9A-Z]{,16}n$|^PT\d{23}$|^RO\d{2}[A-Z]{4}[0-9A-Z]{16}$|^SM\d{2}[A-Z]\d{10}[0-9A-Z]{12}$|^SA\d{4}[0-9A-Z]{18}$|^RS\d{20}$|^SK\d{22}$|^SI\d{17}$|^ES\d{22}$|^SE\d{22}$|^CH\d{7}[0-9A-Z]{12}$|^TN59\d{20}$|^TR\d{7}[0-9A-Z]{17}$|^AE\d{21}$|^GB\d{2}[A-Z]{4}\d{14}$
  • ]
  • ]
  • ]
    • DepositInformation
    {
      "id": "112233",
      "customerId": "10001",
      "accountId": "2100002",
      "slipId": "5009964049",
      "fundingTransactionId": "500005",
      "creationTime": "2021-07-15T17:54:12Z",
      "expirationTime": "2021-07-15T17:54:12Z",
      "status": "FAILED",
      "statusReason": "string",
      "nextStatus": [
        "FAILED"
      ],
      "action": "NONE",
      "redirectUrl": {
        "rel": "REDIRECT_PAYMENT",
        "href": "https://api.paysafe.com/card/redirect/372b5ee7-6360-4403-b444-164f8f1d2709",
        "method": "GET"
      },
      "paymentOption": "CARD",
      "refundable": true,
      "instrumentValidationRules": [
        {
          "instrumentType": "CARD",
          "fields": [
            {
              "fieldName": "iban",
              "validations": [
                {
                  "id": "VALID_IBAN",
                  "message": "Please enter valid IBAN.",
                  "regexp": "^ALd{10}[0-9A-Z]{16}$|^ADd{10}[0-9A-Z]{12}$|^ATd{18}$|^BHd{2}[A-Z]{4}[0-9A-Z]{14}$|^BEd{14}$|^BAd{18}$|^BGd{2}[A-Z]{4}d{6}[0-9A-Z]{8}$|^HRd{19}$|^CYd{10}[0-9A-Z]{16}$|^CZd{22}$|^DKd{16}$|^FOd{16}$|^GLd{16}$|^DOd{2}[0-9A-Z]{4}d{20}$|^EEd{18}$|^FId{16}$|^FRd{12}[0-9A-Z]{11}d{2}$|^GEd{2}[A-Z]{2}d{16}$|^DEd{20}$|^GId{2}[A-Z]{4}[0-9A-Z]{15}$|^GRd{9}[0-9A-Z]{16}$|^HUd{26}$|^ISd{24}$|^IEd{2}[A-Z]{4}d{14}$|^ILd{21}$|^ITd{2}[A-Z]d{10}[0-9A-Z]{12}$|^[A-Z]{2}d{5}[0-9A-Z]{13}$|^KWd{2}[A-Z]{4}22!$|^LVd{2}[A-Z]{4}[0-9A-Z]{13}$|^LBd{6}[0-9A-Z]{20}$|^LId{7}[0-9A-Z]{12}$|^LTd{18}$|^LUd{5}[0-9A-Z]{13}$|^MKd{5}[0-9A-Z]{10}d{2}$|^MTd{2}[A-Z]{4}d{5}[0-9A-Z]{18}$|^MR13d{23}$|^MUd{2}[A-Z]{4}d{19}[A-Z]{3}$|^MCd{12}[0-9A-Z]{11}d{2}$|^MEd{20}$|^NLd{2}[A-Z]{4}d{10}$|^NOd{13}$|^PLd{10}[0-9A-Z]{,16}n$|^PTd{23}$|^ROd{2}[A-Z]{4}[0-9A-Z]{16}$|^SMd{2}[A-Z]d{10}[0-9A-Z]{12}$|^SAd{4}[0-9A-Z]{18}$|^RSd{20}$|^SKd{22}$|^SId{17}$|^ESd{22}$|^SEd{22}$|^CHd{7}[0-9A-Z]{12}$|^TN59d{20}$|^TRd{7}[0-9A-Z]{17}$|^AEd{21}$|^GBd{2}[A-Z]{4}d{14}$"
                }
              ]
            }
          ]
        }
      ]
    }