Skip to main content

Documentation

BIC/SWIFT Numbers for Testing

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

BIC/SWIFT Number for Successful Response

Use this BIC/SWIFT number in the sandbox to simulate a successful response:

  • BARCGB22

BIC/SWIFT Numbers for Errors

Use the following BIC/SWIFT numbers in the sandbox to simulate errors:

IBAN

Type of Error

BARCGB23

INVALID_SWIFT_BIC(NOT_FOUND) The BIC/SWIFT number was not recognized.

BARCGB22A

INVALID_SWIFT_BIC(LENGTH) Length of BIC/SWIFT is not valid, and must be either 8 or 11 characters long.

Examples

    • Create Beneficiary with Vaild BIC/SWIFT

      • curl --location --request POST 'https://sandbox.rapyd.net/v1/payouts/beneficiary' \
        --header 'Content-Type: application/json' \
        --header 'access_key: AAFEB92CD37F' \
        --header 'salt: 54b0ff69b5d85' \
        --header 'timestamp: 1652618791' \
        --header 'signature: ZjQ2Yzk1YzQ4Y2FjMTNTM2YzVlYTcxOGVjZjFlODI1YTMwZg==' \
        --data-raw '{
            "category": "bank",
            "bank_name": "Bank of Merchants",
            "country": "CA",
            "currency": "USD",
            "entity_type": "individual",
            "first_name": "John",
            "last_name": "Doe",
            "identification_type": "identification_id",
            "identification_value": "12p3456178h9",
            "merchant_reference_id": "JDho00ep1",
            "address": "1 Main Street",
            "city": "Montreal",
            "state": "Quebec",
            "postcode": "12345",
            "account_number": "1234p56ph007",
            "bic_swift": "BARCGB22"
        }'
        {
            "status": {
                "error_code": "",
                "status": "SUCCESS",
                "message": "",
                "response_code": "",
                "operation_id": "4948467d-1c90-4fb5-95e9-3353c8ae1a43"
            },
            "data": {
                "id": "beneficiary_7e4912f745a5fa9cdfc9f457c9bb44f7",
                "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": "1234p56ph007",
                "currency": "USD",
                "identification_type": "identification_id",
                "identification_value": "12p3456178h9",
                "bank_name": "Bank of Merchants",
                "merchant_reference_id": "JDho00ep1",
                "bic_swift": "BARCGB22",
                "category": "bank"
            }
        }
    • Create Beneficiary with Invalid BIC/SWIFT- Not Found

      • curl --location --request POST 'https://sandbox.rapyd.net/v1/payouts/beneficiary' \
        --header 'Content-Type: application/json' \
        --header 'access_key: AAFEB92CC763D37F' \
        --header 'salt: b1f8c5d0a35' \
        --header 'timestamp: 1652618572' \
        --header 'signature: ODZjMWNhYmEzc2ZYWNlMGI2Yg==' \
        
        --data-raw '{
            "category": "bank",
            "bank_name": "Bank of Merchants",
            "country": "CA",
            "currency": "USD",
            "entity_type": "individual",
            "first_name": "John",
            "last_name": "Doe",
            "identification_type": "identification_id",
            "identification_value": "12p3456178h9",
            "merchant_reference_id": "JDho00ep1",
            "address": "1 Main Street",
            "city": "Montreal",
            "state": "Quebec",
            "postcode": "12345",
            "account_number": "1234p56ph007",
            "bic_swift": "BARCGB23"
        }'
        {
            "status": {
                "error_code": "INVALID_SWIFT_BIC(NOT_FOUND)",
                "status": "ERROR",
                "message": "Was not found. Check that it is correct.",
                "response_code": "INVALID_SWIFT_BIC(NOT_FOUND)",
                "operation_id": "fd87a0d1-ea86-438d-a50c-c2469914801d"
            }
        }
    • Create Beneficiary with Invalid BIC/SWIFT Length

      • curl --location --request POST 'https://sandbox.rapyd.net/v1/payouts/beneficiary' \
        --header 'Content-Type: application/json' \
        --header 'access_key: AAFEB92CC763F937F' \
        --header 'salt: 3eaccf45be3f9' \
        --header 'timestamp: 1652618939' \
        --header 'signature: YWFmNWNhM2RiNTNmMzAjZTA0NTU5MDRiMQ==' \
        --data-raw '{
            "category": "bank",
            "bank_name": "Bank of Merchants",
            "country": "CA",
            "currency": "USD",
            "entity_type": "individual",
            "first_name": "John",
            "last_name": "Doe",
            "identification_type": "identification_id",
            "identification_value": "12p34561789",
            "merchant_reference_id": "JDho0ep1",
            "address": "1 Main Street",
            "city": "Montreal",
            "state": "Quebec",
            "postcode": "12345",
            "account_number": "1234p56p007",
            "bic_swift": "BARCGB22A"
        }'
        {
            "status": {
                "error_code": "INVALID_SWIFT_BIC(LENGTH)",
                "status": "ERROR",
                "message": "Invalid length. Only 8 or 11 digits",
                "response_code": "INVALID_SWIFT_BIC(LENGTH)",
                "operation_id": "66651be4-3fa1-4e54-8ba3-6890b0399dde"
            }
        }

Related Information