Skip to main content

Documentation

IBAN Numbers for Testing

When you test API calls for creating beneficiaries or payouts in the sandbox, you can use specific IBAN numbers for successful responses and errors that simulate the production environment.

IBAN Number for Successful Response

Use this IBAN in the sandbox to simulate a successful response:

  • DE75512108001245126199

IBAN Numbers for Errors

Use the following IBAN numbers in the sandbox to simulate errors:

IBAN

Type of Error

DR75512108001245126199 1275512108001245126199

INVALID_IBAN(COUNTRY_NOT_SUPPORTED). Country not supported or not entered.

DE75512108001245126191

INVALID_IBAN(CHECK_DIGIT). The characters in the IBAN are not valid.

DE755121080012451261 DE755121080012451261991

INVALID_IBAN(LENGTH). Length of IBAN is not valid.

Examples

    • Create Beneficiary with Vaild IBAN

      • curl --location --request POST 'https://sandbox.rapyd.net/v1/payouts/beneficiary' \
        --header 'Content-Type: application/json' \
        --header 'access_key: AAFEB92CC763F' \
        --header 'salt: 4dc43425598' \
        --header 'timestamp: 1652192810' \
        --header 'signature: ZGRlNDQ0NWViWZmNjc2ZQ==' \
        --data-raw '{
            "category": "bank",
            "country": "CA",
            "currency": "USD",
            "entity_type": "individual",
            "first_name": "John",
            "last_name": "Doe",
            "identification_type": "identification_id",
            "identification_value": "1234561789",
            "merchant_reference_id": "JDoe1",
            "address": "1 Main Street",
            "city": "Montreal",
            "state": "Quebec",
            "postcode": "12345",
            "account_number": "1234p567",
            "iban": "DE75512108001245126199"
        }'
        {
            "status": {
                "error_code": "",
                "status": "SUCCESS",
                "message": "",
                "response_code": "",
                "operation_id": "9e5d6bb7-4554-4778-88ee-b43a11680f0b"
            },
            "data": {
                "id": "beneficiary_87320c751a9861ef11b28f4f8199cc59",
                "last_name": "Doe",
                "first_name": "John",
                "country": "CA",
                "entity_type": "individual",
                "address": "1 Main Street",
                "name": "John Doe",
                "postcode": "12345",
                "city": "Montreal",
                "state": "Quebec",
                "account_number": "1234p567",
                "currency": "USD",
                "identification_type": "identification_id",
                "identification_value": "1234561789",
                "bank_name": "Societe Generale",
                "merchant_reference_id": "JDoe1",
                "iban": "DE75512108001245126199",
                "category": "bank"
            }
        }
    • Create Beneficiary with Invalid IBAN - Country not Supported

      • curl --location --request POST 'https://sandbox.rapyd.net/v1/payouts/beneficiary' \
        --header 'Content-Type: application/json' \
        --header 'access_key: AAFEB92C2D37F' \
        --header 'salt: a4195b9032dbe' \
        --header 'timestamp: 1652193213' \
        --header 'signature: MzUwYTc4MDUjZjZGUzYzcxNiZg==' \
        
        --data-raw '{
            "category": "bank",
            "country": "CA",
            "currency": "USD",
            "entity_type": "individual",
            "first_name": "John",
            "last_name": "Doe",
            "identification_type": "identification_id",
            "identification_value": "12p34561789",
            "merchant_reference_id": "JDoep1",
            "address": "1 Main Street",
            "city": "Montreal",
            "state": "Quebec",
            "postcode": "12345",
            "account_number": "1234p56p7",
            "iban": "DR75512108001245126199"
        }'
        {
            "status": {
                "error_code": "INVALID_IBAN(COUNTRY_NOT_SUPPORTED)",
                "status": "ERROR",
                "message": "",
                "response_code": "INVALID_IBAN(COUNTRY_NOT_SUPPORTED)",
                "operation_id": "5fc0ee3c-4d55-496e-84f0-9c46da396db6"
            }
        }
    • Create Beneficiary with Invalid IBAN Length

      • curl --location --request POST 'https://sandbox.rapyd.net/v1/payouts/beneficiary' \
        --header 'Content-Type: application/json' \
        --header 'access_key: AAFEB97F' \
        --header 'salt: a7fbec154a934' \
        --header 'timestamp: 1652193526' \
        --header 'signature: MmYzOTR1Y2EyNjc5N2VhMw==' \
        --data-raw '{
            "category": "bank",
            "country": "CA",
            "currency": "USD",
            "entity_type": "individual",
            "first_name": "John",
            "last_name": "Doe",
            "identification_type": "identification_id",
            "identification_value": "12p34561789",
            "merchant_reference_id": "JDoep1",
            "address": "1 Main Street",
            "city": "Montreal",
            "state": "Quebec",
            "postcode": "12345",
            "account_number": "1234p56p7",
            "iban": "DE755121080012451261"
        }'
        {
            "status": {
                "error_code": "INVALID_IBAN(LENGTH)",
                "status": "ERROR",
                "message": "",
                "response_code": "INVALID_IBAN(LENGTH)",
                "operation_id": "7723da48-f3f5-4ede-9abd-b6a411791308"
            }
        }
    • Create Beneficiary with Invalid IBAN Characters

      • curl --location --request POST 'https://sandbox.rapyd.net/v1/payouts/beneficiary' \
        --header 'Content-Type: application/json' \
        --header 'access_key: AAFEB9272D37F' \
        --header 'salt: 596d2abc434a830' \
        --header 'timestamp: 1652193404' \
        --header 'signature: NGViOWRlNjZiMmNiYzRjZWI1MzcjOTQ2OA==' \
        --data-raw '{
            "category": "bank",
            "country": "CA",
            "currency": "USD",
            "entity_type": "individual",
            "first_name": "John",
            "last_name": "Doe",
            "identification_type": "identification_id",
            "identification_value": "12p34561789",
            "merchant_reference_id": "JDoep1",
            "address": "1 Main Street",
            "city": "Montreal",
            "state": "Quebec",
            "postcode": "12345",
            "account_number": "1234p56p7",
            "iban": "DE75512108001245126191"
        }'
        {
            "status": {
                "error_code": "INVALID_IBAN(CHECK_DIGIT)",
                "status": "ERROR",
                "message": "",
                "response_code": "INVALID_IBAN(CHECK_DIGIT)",
                "operation_id": "c6c187e4-3a50-4541-b510-03987544f338"
            }
        }

Related Information