General testing

To test payouts, you need to create a valid Bank Account and create a Payout to it. You can use these test accounts:

IBAN test account

  • IBAN - FR7630004000031234567890143
  • BIC - BNPAFRPP

GB test account

  • AccountNumber - 55779911
  • SortCode - 200000

You can then use the Sandbox operations view of the Dashboard to process the payout.

Instant payout testing

To simulate the fallback to a standard payout from an instant payout due to a banking error, you can use the following IBAN account:

  • IBAN - FR541558929750ZZZZZZAC01915
  • BIC - CMBRFR2BXXX
Request example
{

    "AuthorId": "145397183",

    "Tag": "IP banking error",

    "DebitedFunds": {

        "Currency": "EUR",

        "Amount": 1000

    },

    "Fees": {

        "Currency": "EUR",

        "Amount": 10

    },

    "BankAccountId": "158988175",

    "DebitedWalletId": "145397873",

    "BankWireRef": "Postman",

    "PayoutModeRequested":"INSTANT_PAYMENT"

}

When viewing the payout, the API returns a fallbacked payout (i.e., the STANDARD mode was applied).

Response example
{

    "ModeRequested": "INSTANT_PAYMENT",

    "ModeApplied": "STANDARD",

    "FallbackReason": {

        "Code": "001999",

        "Message": "Generic Operation error"

    },

    "EndToEndId": "77a7f37820fd4e49910e6bd3c04c919c",

    "Id": "158988302",

    "Tag": "IP banking error",

    "CreationDate": 1672235391,

    "AuthorId": "145397183",

    "CreditedUserId": null,

    "DebitedFunds": {

        "Currency": "EUR",

        "Amount": 1000

    },

    "CreditedFunds": {

        "Currency": "EUR",

        "Amount": 990

    },

    "Fees": {

        "Currency": "EUR",

        "Amount": 10

    },

    "Status": "SUCCEEDED",

    "ResultCode": "000000",

    "ResultMessage": "Success",

    "ExecutionDate": 1672235391,

    "Type": "PAYOUT",

    "Nature": "REGULAR",

    "CreditedWalletId": null,

    "DebitedWalletId": "145397873",

    "PaymentType": "BANK_WIRE",

    "BankAccountId": "158988175",

    "BankWireRef": "Postman"

}

To simulate a non-reachable bank account, use the IP1070 value for the BankWireRef parameter.

Request example
{

    "AuthorId":"142036728",

    "DebitedFunds":{

        "Currency":"EUR",

        "Amount":1260

    },

    "Fees":{

        "Currency":"EUR",

        "Amount":12

    },

    "BankAccountId":"151986981",

    "DebitedWalletId":"145389978",

    "BankWireRef":"IP1070",

    "PayoutModeRequested":"INSTANT_PAYMENT"

}
Response
{

    "InstantPayout": {

        "IsReachable": false,

        "UnreachableReason": {

            "Code": "130010",

            "Message": "Generic operation error"

        }

    }

}

The following unreachable reasons can be returned:

  • 130006 - technical error, please try again later
  • 130007 - Destination Bank is not reachable
  • 130008 - Duplicate transaction identified
  • 130009 - The destination IBAN is not valid
  • 130010 - Generic operation error