Onboarding API Specifications
Version: 2016-06-11
Pass the Authorization header in your request as "Authorization: Token INSERT_KEY_HERE. Contact Beanstream to get an API Key generated for you if you don't have one.
Name | In |
---|---|
api_key | header |
Creates a new European SEPA application. The status of the application will be returned in the status object. A Location header that points to the URL of the new resource will be available in the response. The Location header has an application ID that should be used for all future requests to that application.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | body | application | Application details | SepaEurApplicationRequest |
Parameter Schema Definitions |
---|
SepaEurApplicationRequest
{
Defines a SEPA European application
id
:
integer
description:
This application identifier is used to identify an application. It is auto-generated by the API [ReadOnly] merchant_id : integer description:This merchant identifier is populated when the application is approved and a merchant account has been associated. [ReadOnly] pricing_id* : string maxLength: 32 description:This is the reference number for the pricing package associated with an application status : Status { Defines information about the application. [ReadOnly] state : string Enum (4) in_progress in_review rejected approved description:The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } applicant* : EftApplicant { The individual completing the application first_name* : string maxLength: 64 last_name* : string maxLength: 64 phone_number* : string maxLength: 15 agreement* : Agreement { Defines an terms and conditions agreement between a merchant and Beanstream name* : string description:Defines the name of the agreement. Use the application type, as is in the url: eg. PSP-CAD version* : string description:Defines the version of the agreement. Use the version number that is in the terms document file name. For example http:...com/terms/api/psp-cad-v1.0-062016.htm you would use: 1.0-062016 timestamp* : string format: date-time description:Defines the date of the application terms and conditions agreeent in ISO 8601 format with a timezone [ReadOnly] } email* : string maxLength: 500 } business* : SepaEurBusiness { The details of a European business company_name* : string maxLength: 64 annual_sales* : number format: float32 description:This is the annual sales volume in EUR. entity_type* : string Enum (9) public_limited private_limited limited_liability_partnership combination_partnership partnership sole_trader community_interest charitable_incorporated other description:This is the business entity type website_url : string format: uri maxLength: 128 legal_name* : string maxLength: 64 start_date* : string format: date-time description:This is the business start date in ISO 8601 format with a timezone registration_number : string maxLength: 32 dba_name* : string maxLength: 32 description:This is the "doing business as" name batch_settings* : BatchSettings { The details of a batch requirements frequency* : string Enum (7) daily weekly bi_weekly monthly bi_monthly semi_annually annually average_amount* : number format: float32 maximum_amount* : number format: float32 } address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } directors* : array of SepaEurDirector { Defines a SEPA European business owner or director first_name* : string maxLength: 64 last_name* : string maxLength: 64 date_of_birth* : string format: date-time description:Defines the birthday in ISO 8601 format with a timezone start_date* : string format: date-time description:Defines the ownership start date in ISO 8601 format with a timezone percentage : number format: float32 maximum: 100 minimum: 0 description:Defines the percentage, from 0.00 to 100.00, of the company ownership. address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } } bank_account* : EuropeanBankAccount { Defines a European bank account owner_name* : string maxLength: 64 bank_name* : string maxLength: 32 swift_code* : string maxLength: 11 description:Must be either 8 or 11 characters in length. Characters 1-4 are letters (A-Z). Characters 5-6 are a valid ISO 3166-1 Alpha-2 country code (https://en.wikipedia.org/wiki/ISO3166-1alpha-2). To verify a SWIFT/BIC code and for example SWIFT/BIC codes, see https://formvalidation.io/guide/validators/bic/ iban* : string maxLength: 34 description:Must be valid IBAN. To verify an IBAN and get example IBANS, see https://formvalidation.io/guide/validators/iban bank_account_contact : BankAccountContact { Defines the primary contact for the bank account first_name : string maxLength: 64 description:First name of the primary contact for the bank account. last_name : string maxLength: 64 description:Last name of the primary contact for the bank account. email : string maxLength: 500 description:Email of the primary contact for the bank account. phone_number : string maxLength: 15 description:Phone number of the primary contact for the bank account. } } documents : array of SepaEurFile { Defines a document that is required for application approval. name* : string Enum (7) copy_id void_cheque bank_statement certificate registration board_members mandate description:Name of the document. This will match to one of the list of possible files. This is a read-only attribute. The options are "Copy ID (Owner and/or Principal) - govt issued photo ID", "Void Check or Bank Statement", "Certificate of Incorporation (if applicable)", "Non-Profit Registration Documents (if applicable)", "List of Board Members (public and NFP companies)" and "Mandate" type* : string Enum (6) jpg jpeg doc docx pdf png description:File type of the document; accepted file formats. notes : string description:Description of the document and the contents that it must contain. base64* : string description:The document data, submitted as a base64 encoded string.. uri : string description:The URI that allows retrival of the documents using the GET /appplicatins/{id}/documents/{name}. [ReadOnly] } } custom_data : object description:Optional custom data, must be a JSON object. Example: {"id": 12345} } |
Code | Description | Schema |
---|---|---|
201 | Application created | Status |
400 | Invalid request | Array of Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
Status
{
Defines information about the application. [ReadOnly]
state
:
string
Enum
(4)
in_progress
in_review
rejected
approved
description:
The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } |
Retrieves all European SEPA applications referenced by the given criteria in the url. A search criteria can be a combination of the following: - state={state} - Accepted values are "in_progress", "in_review", "on_hold", "approved" "rejected", "live" and "temp_disabled" - createdbefore={date} - createdafter={date} - updatedbefore={date} - updatedafter={date}
Documents file data will be excluded to limit the amount of data on the wire.
No parameters
Code | Description | Schema |
---|---|---|
200 | Application(s) retrieved | Array of SepaEurApplicationRequest |
400 | Invalid request | Array of Error |
404 | Applications not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
SepaEurApplicationRequest
{
Defines a SEPA European application
id
:
integer
description:
This application identifier is used to identify an application. It is auto-generated by the API [ReadOnly] merchant_id : integer description:This merchant identifier is populated when the application is approved and a merchant account has been associated. [ReadOnly] pricing_id* : string maxLength: 32 description:This is the reference number for the pricing package associated with an application status : Status { Defines information about the application. [ReadOnly] state : string Enum (4) in_progress in_review rejected approved description:The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } applicant* : EftApplicant { The individual completing the application first_name* : string maxLength: 64 last_name* : string maxLength: 64 phone_number* : string maxLength: 15 agreement* : Agreement { Defines an terms and conditions agreement between a merchant and Beanstream name* : string description:Defines the name of the agreement. Use the application type, as is in the url: eg. PSP-CAD version* : string description:Defines the version of the agreement. Use the version number that is in the terms document file name. For example http:...com/terms/api/psp-cad-v1.0-062016.htm you would use: 1.0-062016 timestamp* : string format: date-time description:Defines the date of the application terms and conditions agreeent in ISO 8601 format with a timezone [ReadOnly] } email* : string maxLength: 500 } business* : SepaEurBusiness { The details of a European business company_name* : string maxLength: 64 annual_sales* : number format: float32 description:This is the annual sales volume in EUR. entity_type* : string Enum (9) public_limited private_limited limited_liability_partnership combination_partnership partnership sole_trader community_interest charitable_incorporated other description:This is the business entity type website_url : string format: uri maxLength: 128 legal_name* : string maxLength: 64 start_date* : string format: date-time description:This is the business start date in ISO 8601 format with a timezone registration_number : string maxLength: 32 dba_name* : string maxLength: 32 description:This is the "doing business as" name batch_settings* : BatchSettings { The details of a batch requirements frequency* : string Enum (7) daily weekly bi_weekly monthly bi_monthly semi_annually annually average_amount* : number format: float32 maximum_amount* : number format: float32 } address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } directors* : array of SepaEurDirector { Defines a SEPA European business owner or director first_name* : string maxLength: 64 last_name* : string maxLength: 64 date_of_birth* : string format: date-time description:Defines the birthday in ISO 8601 format with a timezone start_date* : string format: date-time description:Defines the ownership start date in ISO 8601 format with a timezone percentage : number format: float32 maximum: 100 minimum: 0 description:Defines the percentage, from 0.00 to 100.00, of the company ownership. address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } } bank_account* : EuropeanBankAccount { Defines a European bank account owner_name* : string maxLength: 64 bank_name* : string maxLength: 32 swift_code* : string maxLength: 11 description:Must be either 8 or 11 characters in length. Characters 1-4 are letters (A-Z). Characters 5-6 are a valid ISO 3166-1 Alpha-2 country code (https://en.wikipedia.org/wiki/ISO3166-1alpha-2). To verify a SWIFT/BIC code and for example SWIFT/BIC codes, see https://formvalidation.io/guide/validators/bic/ iban* : string maxLength: 34 description:Must be valid IBAN. To verify an IBAN and get example IBANS, see https://formvalidation.io/guide/validators/iban bank_account_contact : BankAccountContact { Defines the primary contact for the bank account first_name : string maxLength: 64 description:First name of the primary contact for the bank account. last_name : string maxLength: 64 description:Last name of the primary contact for the bank account. email : string maxLength: 500 description:Email of the primary contact for the bank account. phone_number : string maxLength: 15 description:Phone number of the primary contact for the bank account. } } documents : array of SepaEurFile { Defines a document that is required for application approval. name* : string Enum (7) copy_id void_cheque bank_statement certificate registration board_members mandate description:Name of the document. This will match to one of the list of possible files. This is a read-only attribute. The options are "Copy ID (Owner and/or Principal) - govt issued photo ID", "Void Check or Bank Statement", "Certificate of Incorporation (if applicable)", "Non-Profit Registration Documents (if applicable)", "List of Board Members (public and NFP companies)" and "Mandate" type* : string Enum (6) jpg jpeg doc docx pdf png description:File type of the document; accepted file formats. notes : string description:Description of the document and the contents that it must contain. base64* : string description:The document data, submitted as a base64 encoded string.. uri : string description:The URI that allows retrival of the documents using the GET /appplicatins/{id}/documents/{name}. [ReadOnly] } } custom_data : object description:Optional custom data, must be a JSON object. Example: {"id": 12345} } |
Updates a European SEPA application referenced by the given applicationId.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | path | applicationId | The id of the application to update | integer |
true | body | document | Application details | SepaEurApplicationRequest |
Parameter Schema Definitions |
---|
SepaEurApplicationRequest
{
Defines a SEPA European application
id
:
integer
description:
This application identifier is used to identify an application. It is auto-generated by the API [ReadOnly] merchant_id : integer description:This merchant identifier is populated when the application is approved and a merchant account has been associated. [ReadOnly] pricing_id* : string maxLength: 32 description:This is the reference number for the pricing package associated with an application status : Status { Defines information about the application. [ReadOnly] state : string Enum (4) in_progress in_review rejected approved description:The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } applicant* : EftApplicant { The individual completing the application first_name* : string maxLength: 64 last_name* : string maxLength: 64 phone_number* : string maxLength: 15 agreement* : Agreement { Defines an terms and conditions agreement between a merchant and Beanstream name* : string description:Defines the name of the agreement. Use the application type, as is in the url: eg. PSP-CAD version* : string description:Defines the version of the agreement. Use the version number that is in the terms document file name. For example http:...com/terms/api/psp-cad-v1.0-062016.htm you would use: 1.0-062016 timestamp* : string format: date-time description:Defines the date of the application terms and conditions agreeent in ISO 8601 format with a timezone [ReadOnly] } email* : string maxLength: 500 } business* : SepaEurBusiness { The details of a European business company_name* : string maxLength: 64 annual_sales* : number format: float32 description:This is the annual sales volume in EUR. entity_type* : string Enum (9) public_limited private_limited limited_liability_partnership combination_partnership partnership sole_trader community_interest charitable_incorporated other description:This is the business entity type website_url : string format: uri maxLength: 128 legal_name* : string maxLength: 64 start_date* : string format: date-time description:This is the business start date in ISO 8601 format with a timezone registration_number : string maxLength: 32 dba_name* : string maxLength: 32 description:This is the "doing business as" name batch_settings* : BatchSettings { The details of a batch requirements frequency* : string Enum (7) daily weekly bi_weekly monthly bi_monthly semi_annually annually average_amount* : number format: float32 maximum_amount* : number format: float32 } address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } directors* : array of SepaEurDirector { Defines a SEPA European business owner or director first_name* : string maxLength: 64 last_name* : string maxLength: 64 date_of_birth* : string format: date-time description:Defines the birthday in ISO 8601 format with a timezone start_date* : string format: date-time description:Defines the ownership start date in ISO 8601 format with a timezone percentage : number format: float32 maximum: 100 minimum: 0 description:Defines the percentage, from 0.00 to 100.00, of the company ownership. address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } } bank_account* : EuropeanBankAccount { Defines a European bank account owner_name* : string maxLength: 64 bank_name* : string maxLength: 32 swift_code* : string maxLength: 11 description:Must be either 8 or 11 characters in length. Characters 1-4 are letters (A-Z). Characters 5-6 are a valid ISO 3166-1 Alpha-2 country code (https://en.wikipedia.org/wiki/ISO3166-1alpha-2). To verify a SWIFT/BIC code and for example SWIFT/BIC codes, see https://formvalidation.io/guide/validators/bic/ iban* : string maxLength: 34 description:Must be valid IBAN. To verify an IBAN and get example IBANS, see https://formvalidation.io/guide/validators/iban bank_account_contact : BankAccountContact { Defines the primary contact for the bank account first_name : string maxLength: 64 description:First name of the primary contact for the bank account. last_name : string maxLength: 64 description:Last name of the primary contact for the bank account. email : string maxLength: 500 description:Email of the primary contact for the bank account. phone_number : string maxLength: 15 description:Phone number of the primary contact for the bank account. } } documents : array of SepaEurFile { Defines a document that is required for application approval. name* : string Enum (7) copy_id void_cheque bank_statement certificate registration board_members mandate description:Name of the document. This will match to one of the list of possible files. This is a read-only attribute. The options are "Copy ID (Owner and/or Principal) - govt issued photo ID", "Void Check or Bank Statement", "Certificate of Incorporation (if applicable)", "Non-Profit Registration Documents (if applicable)", "List of Board Members (public and NFP companies)" and "Mandate" type* : string Enum (6) jpg jpeg doc docx pdf png description:File type of the document; accepted file formats. notes : string description:Description of the document and the contents that it must contain. base64* : string description:The document data, submitted as a base64 encoded string.. uri : string description:The URI that allows retrival of the documents using the GET /appplicatins/{id}/documents/{name}. [ReadOnly] } } custom_data : object description:Optional custom data, must be a JSON object. Example: {"id": 12345} } |
Code | Description | Schema |
---|---|---|
200 | Application Updated. | Status |
400 | Invalid request | Array of Error |
404 | Application not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
Status
{
Defines information about the application. [ReadOnly]
state
:
string
Enum
(4)
in_progress
in_review
rejected
approved
description:
The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } |
Retrieves a European SEPA application referenced by the given applicationId.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | path | applicationId | The id of the application to retrieve | string |
Code | Description | Schema |
---|---|---|
200 | Application retrieved | SepaEurApplicationResponse |
400 | Invalid request | Array of Error |
404 | Application not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
SepaEurApplicationResponse
{
Defines a SEPA European application
id
:
integer
description:
This application identifier is used to identify an application. It is auto-generated by the API [ReadOnly] merchant_id : integer description:This merchant identifier is populated when the application is approved and a merchant account has been associated. [ReadOnly] pricing_id* : string maxLength: 32 description:This is the reference number for the pricing package associated with an application status : StatusResponse { Defines information about the application. [ReadOnly] state : string Enum (4) in_progress in_review rejected approved description:The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] submitted_on : string format: date-time description:Defines the date when the application was put into review in ISO 8601 format with a timezone [ReadOnly] approved_on : string format: date-time description:Defines the date when the application was approved in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } applicant* : EftApplicant { The individual completing the application first_name* : string maxLength: 64 last_name* : string maxLength: 64 phone_number* : string maxLength: 15 agreement* : Agreement { Defines an terms and conditions agreement between a merchant and Beanstream name* : string description:Defines the name of the agreement. Use the application type, as is in the url: eg. PSP-CAD version* : string description:Defines the version of the agreement. Use the version number that is in the terms document file name. For example http:...com/terms/api/psp-cad-v1.0-062016.htm you would use: 1.0-062016 timestamp* : string format: date-time description:Defines the date of the application terms and conditions agreeent in ISO 8601 format with a timezone [ReadOnly] } email* : string maxLength: 500 } business* : SepaEurBusiness { The details of a European business company_name* : string maxLength: 64 annual_sales* : number format: float32 description:This is the annual sales volume in EUR. entity_type* : string Enum (9) public_limited private_limited limited_liability_partnership combination_partnership partnership sole_trader community_interest charitable_incorporated other description:This is the business entity type website_url : string format: uri maxLength: 128 legal_name* : string maxLength: 64 start_date* : string format: date-time description:This is the business start date in ISO 8601 format with a timezone registration_number : string maxLength: 32 dba_name* : string maxLength: 32 description:This is the "doing business as" name batch_settings* : BatchSettings { The details of a batch requirements frequency* : string Enum (7) daily weekly bi_weekly monthly bi_monthly semi_annually annually average_amount* : number format: float32 maximum_amount* : number format: float32 } address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } directors* : array of SepaEurDirector { Defines a SEPA European business owner or director first_name* : string maxLength: 64 last_name* : string maxLength: 64 date_of_birth* : string format: date-time description:Defines the birthday in ISO 8601 format with a timezone start_date* : string format: date-time description:Defines the ownership start date in ISO 8601 format with a timezone percentage : number format: float32 maximum: 100 minimum: 0 description:Defines the percentage, from 0.00 to 100.00, of the company ownership. address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } } bank_account* : EuropeanBankAccount { Defines a European bank account owner_name* : string maxLength: 64 bank_name* : string maxLength: 32 swift_code* : string maxLength: 11 description:Must be either 8 or 11 characters in length. Characters 1-4 are letters (A-Z). Characters 5-6 are a valid ISO 3166-1 Alpha-2 country code (https://en.wikipedia.org/wiki/ISO3166-1alpha-2). To verify a SWIFT/BIC code and for example SWIFT/BIC codes, see https://formvalidation.io/guide/validators/bic/ iban* : string maxLength: 34 description:Must be valid IBAN. To verify an IBAN and get example IBANS, see https://formvalidation.io/guide/validators/iban bank_account_contact : BankAccountContact { Defines the primary contact for the bank account first_name : string maxLength: 64 description:First name of the primary contact for the bank account. last_name : string maxLength: 64 description:Last name of the primary contact for the bank account. email : string maxLength: 500 description:Email of the primary contact for the bank account. phone_number : string maxLength: 15 description:Phone number of the primary contact for the bank account. } } documents : array of SepaEurFile { Defines a document that is required for application approval. name* : string Enum (7) copy_id void_cheque bank_statement certificate registration board_members mandate description:Name of the document. This will match to one of the list of possible files. This is a read-only attribute. The options are "Copy ID (Owner and/or Principal) - govt issued photo ID", "Void Check or Bank Statement", "Certificate of Incorporation (if applicable)", "Non-Profit Registration Documents (if applicable)", "List of Board Members (public and NFP companies)" and "Mandate" type* : string Enum (6) jpg jpeg doc docx pdf png description:File type of the document; accepted file formats. notes : string description:Description of the document and the contents that it must contain. base64* : string description:The document data, submitted as a base64 encoded string.. uri : string description:The URI that allows retrival of the documents using the GET /appplicatins/{id}/documents/{name}. [ReadOnly] } } custom_data : object description:Optional custom data, must be a JSON object. Example: {"id": 12345} } |
Creates a European SEPA application document for the referenced applicationId. Returns the status of the application.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | path | applicationId | The id of the application to create a document in. | integer |
true | body | document | Document details | SepaEurFile |
Parameter Schema Definitions |
---|
SepaEurFile
{
Defines a document that is required for application approval.
name*
:
string
Enum
(7)
copy_id
void_cheque
bank_statement
certificate
registration
board_members
mandate
description:
Name of the document. This will match to one of the list of possible files. This is a read-only attribute. The options are "Copy ID (Owner and/or Principal) - govt issued photo ID", "Void Check or Bank Statement", "Certificate of Incorporation (if applicable)", "Non-Profit Registration Documents (if applicable)", "List of Board Members (public and NFP companies)" and "Mandate" type* : string Enum (6) jpg jpeg doc docx pdf png description:File type of the document; accepted file formats. notes : string description:Description of the document and the contents that it must contain. base64* : string description:The document data, submitted as a base64 encoded string.. uri : string description:The URI that allows retrival of the documents using the GET /appplicatins/{id}/documents/{name}. [ReadOnly] } |
Code | Description | Schema |
---|---|---|
200 | Document created | Status |
400 | Invalid request | Array of Error |
404 | Application not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
Status
{
Defines information about the application. [ReadOnly]
state
:
string
Enum
(4)
in_progress
in_review
rejected
approved
description:
The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } |
Deletes a European SEPA application document for the referenced applicationId and documentId. Returns the status of the application.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | path | applicationId | The id of the application to delete the document from | integer |
true | path | documentId | The name of the document to delete | string |
Code | Description | Schema |
---|---|---|
204 | Documents Updated | Status |
400 | Invalid request | Array of Error |
404 | Application or Document not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
Status
{
Defines information about the application. [ReadOnly]
state
:
string
Enum
(4)
in_progress
in_review
rejected
approved
description:
The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } |
NOTE: This is for internal use only. If you are integrating to the onboarding API you will not have access to set the status. Our system will do that. Updates a European SEPA application status for the referenced applicationId. Returns the status of the application.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | path | applicationId | The id of the application to update status for | integer |
true | body | status | The status details | Status |
Parameter Schema Definitions |
---|
Status
{
Defines information about the application. [ReadOnly]
state
:
string
Enum
(4)
in_progress
in_review
rejected
approved
description:
The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } |
Code | Description | Schema |
---|---|---|
200 | Status Updated | Status |
400 | Invalid request | Array of Error |
404 | Application not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
Status
{
Defines information about the application. [ReadOnly]
state
:
string
Enum
(4)
in_progress
in_review
rejected
approved
description:
The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } |
Returns latest version of T&Cs doc for a European SEPA application.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | path | partner | The name of the partner, if customized T&Cs have been agreed. Pass "default" for the default version of the document. | string |
true | path | file_type | The format of the T&Cs document to be returned. | string |
Code | Description | Schema |
---|---|---|
200 | Document version info | 200 Response |
400 | Invalid request | Array of Error |
404 | Document not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
200 Response
{
Defines information about the document.
version
:
string
description:
Defines the version of the document returned. name : string format: flow/partner_date:time description:Defines the name of the document returned. } |
Returns T&Cs for a European SEPA application.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | path | partner | The name of the partner, if customized T&Cs have been agreed. Pass "default" for the default version of the document. | string |
true | path | file_type | The format of the T&Cs document to be returned. | string |
true | path | version | The version of the document. | string |
Code | Description | Schema |
---|---|---|
200 | Document retrieved with identifing properties in HTTP header | 200 Response |
400 | Invalid request | Array of Error |
404 | Document not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
200 Response
{
Defines information about the document. [HTTP header]
X-Version
:
string
description:
Defines the version of the document returned. X-Name : string format: flow/partner_date:time description:Defines the name of the document returned. } |
Creates a new United Kingdom BACS application. The status of the application will be returned in the status object. A Location header that points to the URL of the new resource will be available in the response. The Location header has an application ID that should be used for all future requests to that application.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | body | application | Application details | BacsGbpApplicationRequest |
Parameter Schema Definitions |
---|
BacsGbpApplicationRequest
{
Defines a BACS United Kingdom application
id
:
integer
description:
This application identifier is used to identify an application. It is auto-generated by the API [ReadOnly] merchant_id : integer description:This merchant identifier is populated when the application is approved and a merchant account has been associated. [ReadOnly] pricing_id* : string maxLength: 32 description:This is the reference number for the pricing package associated with an application status : Status { Defines information about the application. [ReadOnly] state : string Enum (4) in_progress in_review rejected approved description:The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } applicant* : EftApplicant { The individual completing the application first_name* : string maxLength: 64 last_name* : string maxLength: 64 phone_number* : string maxLength: 15 agreement* : Agreement { Defines an terms and conditions agreement between a merchant and Beanstream name* : string description:Defines the name of the agreement. Use the application type, as is in the url: eg. PSP-CAD version* : string description:Defines the version of the agreement. Use the version number that is in the terms document file name. For example http:...com/terms/api/psp-cad-v1.0-062016.htm you would use: 1.0-062016 timestamp* : string format: date-time description:Defines the date of the application terms and conditions agreeent in ISO 8601 format with a timezone [ReadOnly] } email* : string maxLength: 500 } business* : BacsGbpBusiness { The details of a BACS United Kingdom business company_name* : string maxLength: 64 annual_sales* : number format: float32 description:This is the annual sales volume in GBP. entity_type* : string Enum (9) public_limited private_limited limited_liability_partnership combination_partnership partnership sole_trader community_interest charitable_incorporated other description:This is the business entity type website_url : string format: uri maxLength: 128 legal_name* : string maxLength: 64 start_date* : string format: date-time description:This is the business start date in ISO 8601 format with a timezone registration_number : string maxLength: 32 dba_name* : string maxLength: 32 description:This is the "doing business as" name batch_settings* : BatchSettings { The details of a batch requirements frequency* : string Enum (7) daily weekly bi_weekly monthly bi_monthly semi_annually annually average_amount* : number format: float32 maximum_amount* : number format: float32 } address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } directors* : array of BacsGbpDirector { Defines a BACS United Kingdom business owner or director first_name* : string maxLength: 64 last_name* : string maxLength: 64 date_of_birth* : string format: date-time description:Defines the birthday in ISO 8601 format with a timezone start_date* : string format: date-time description:Defines the the ownership start date in ISO 8601 format with a timezone percentage : number format: float32 maximum: 100 minimum: 0 description:Defines the percentage, from 0.00 to 100.00, of the company ownership. address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } } bank_account* : UnitedKingdomBankAccount { Defines a United Kingdom bank account owner_name* : string maxLength: 64 bank_name* : string maxLength: 32 address : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } sort_code* : string pattern: ^\d{2}-?\d{2}-?\d{2}$ account_number* : string pattern: ^\d{8}$ bank_account_contact : BankAccountContact { Defines the primary contact for the bank account first_name : string maxLength: 64 description:First name of the primary contact for the bank account. last_name : string maxLength: 64 description:Last name of the primary contact for the bank account. email : string maxLength: 500 description:Email of the primary contact for the bank account. phone_number : string maxLength: 15 description:Phone number of the primary contact for the bank account. } } documents : array of BacsGbpFile { Defines a document that is required for application approval. name* : string Enum (7) copy_id void_cheque bank_statement certificate registration board_members direct_debit description:Name of the document. This will match to one of the list of possible files. This is a read-only attribute. The options are "Copy ID (Owner and/or Principal) - govt issued photo ID", "Void Check or Bank Statement", "Certificate of Incorporation (if applicable)", "Non-Profit Registration Documents (if applicable)", "List of Board Members (public and NFP companies)" and "Direct Debit Instructions" type* : string Enum (6) jpg jpeg doc docx pdf png description:File type of the document; accepted file formats. notes : string description:Description of the document and the contents that it must contain. base64* : string description:The document data, submitted as a base64 encoded string.. uri : string description:The URI that allows retrival of the documents using the GET /appplicatins/{id}/documents/{name}. [ReadOnly] } } custom_data : object description:Optional custom data, must be a JSON object. Example: {"id": 12345} } |
Code | Description | Schema |
---|---|---|
201 | Application created | Status |
400 | Invalid request | Array of Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
Status
{
Defines information about the application. [ReadOnly]
state
:
string
Enum
(4)
in_progress
in_review
rejected
approved
description:
The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } |
Retrieves all United Kingdom BACS applications referenced by the given criteria in the url. A search criteria can be a combination of the following: - state={state} - Accepted values are "in_progress", "in_review", "on_hold", "approved" "rejected", "live" and "temp_disabled" - createdbefore={date} - createdafter={date} - updatedbefore={date} - updatedafter={date}
Documents file data will be excluded to limit the amount of data on the wire.
No parameters
Code | Description | Schema |
---|---|---|
200 | Application(s) retrieved | Array of BacsGbpApplicationRequest |
400 | Invalid request | Array of Error |
404 | Applications not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
BacsGbpApplicationRequest
{
Defines a BACS United Kingdom application
id
:
integer
description:
This application identifier is used to identify an application. It is auto-generated by the API [ReadOnly] merchant_id : integer description:This merchant identifier is populated when the application is approved and a merchant account has been associated. [ReadOnly] pricing_id* : string maxLength: 32 description:This is the reference number for the pricing package associated with an application status : Status { Defines information about the application. [ReadOnly] state : string Enum (4) in_progress in_review rejected approved description:The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } applicant* : EftApplicant { The individual completing the application first_name* : string maxLength: 64 last_name* : string maxLength: 64 phone_number* : string maxLength: 15 agreement* : Agreement { Defines an terms and conditions agreement between a merchant and Beanstream name* : string description:Defines the name of the agreement. Use the application type, as is in the url: eg. PSP-CAD version* : string description:Defines the version of the agreement. Use the version number that is in the terms document file name. For example http:...com/terms/api/psp-cad-v1.0-062016.htm you would use: 1.0-062016 timestamp* : string format: date-time description:Defines the date of the application terms and conditions agreeent in ISO 8601 format with a timezone [ReadOnly] } email* : string maxLength: 500 } business* : BacsGbpBusiness { The details of a BACS United Kingdom business company_name* : string maxLength: 64 annual_sales* : number format: float32 description:This is the annual sales volume in GBP. entity_type* : string Enum (9) public_limited private_limited limited_liability_partnership combination_partnership partnership sole_trader community_interest charitable_incorporated other description:This is the business entity type website_url : string format: uri maxLength: 128 legal_name* : string maxLength: 64 start_date* : string format: date-time description:This is the business start date in ISO 8601 format with a timezone registration_number : string maxLength: 32 dba_name* : string maxLength: 32 description:This is the "doing business as" name batch_settings* : BatchSettings { The details of a batch requirements frequency* : string Enum (7) daily weekly bi_weekly monthly bi_monthly semi_annually annually average_amount* : number format: float32 maximum_amount* : number format: float32 } address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } directors* : array of BacsGbpDirector { Defines a BACS United Kingdom business owner or director first_name* : string maxLength: 64 last_name* : string maxLength: 64 date_of_birth* : string format: date-time description:Defines the birthday in ISO 8601 format with a timezone start_date* : string format: date-time description:Defines the the ownership start date in ISO 8601 format with a timezone percentage : number format: float32 maximum: 100 minimum: 0 description:Defines the percentage, from 0.00 to 100.00, of the company ownership. address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } } bank_account* : UnitedKingdomBankAccount { Defines a United Kingdom bank account owner_name* : string maxLength: 64 bank_name* : string maxLength: 32 address : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } sort_code* : string pattern: ^\d{2}-?\d{2}-?\d{2}$ account_number* : string pattern: ^\d{8}$ bank_account_contact : BankAccountContact { Defines the primary contact for the bank account first_name : string maxLength: 64 description:First name of the primary contact for the bank account. last_name : string maxLength: 64 description:Last name of the primary contact for the bank account. email : string maxLength: 500 description:Email of the primary contact for the bank account. phone_number : string maxLength: 15 description:Phone number of the primary contact for the bank account. } } documents : array of BacsGbpFile { Defines a document that is required for application approval. name* : string Enum (7) copy_id void_cheque bank_statement certificate registration board_members direct_debit description:Name of the document. This will match to one of the list of possible files. This is a read-only attribute. The options are "Copy ID (Owner and/or Principal) - govt issued photo ID", "Void Check or Bank Statement", "Certificate of Incorporation (if applicable)", "Non-Profit Registration Documents (if applicable)", "List of Board Members (public and NFP companies)" and "Direct Debit Instructions" type* : string Enum (6) jpg jpeg doc docx pdf png description:File type of the document; accepted file formats. notes : string description:Description of the document and the contents that it must contain. base64* : string description:The document data, submitted as a base64 encoded string.. uri : string description:The URI that allows retrival of the documents using the GET /appplicatins/{id}/documents/{name}. [ReadOnly] } } custom_data : object description:Optional custom data, must be a JSON object. Example: {"id": 12345} } |
Updates a United Kingdom BACS application referenced by the given applicationId.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | path | applicationId | The id of the application to update | integer |
true | body | application | Applicaiton details | BacsGbpApplicationRequest |
Parameter Schema Definitions |
---|
BacsGbpApplicationRequest
{
Defines a BACS United Kingdom application
id
:
integer
description:
This application identifier is used to identify an application. It is auto-generated by the API [ReadOnly] merchant_id : integer description:This merchant identifier is populated when the application is approved and a merchant account has been associated. [ReadOnly] pricing_id* : string maxLength: 32 description:This is the reference number for the pricing package associated with an application status : Status { Defines information about the application. [ReadOnly] state : string Enum (4) in_progress in_review rejected approved description:The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } applicant* : EftApplicant { The individual completing the application first_name* : string maxLength: 64 last_name* : string maxLength: 64 phone_number* : string maxLength: 15 agreement* : Agreement { Defines an terms and conditions agreement between a merchant and Beanstream name* : string description:Defines the name of the agreement. Use the application type, as is in the url: eg. PSP-CAD version* : string description:Defines the version of the agreement. Use the version number that is in the terms document file name. For example http:...com/terms/api/psp-cad-v1.0-062016.htm you would use: 1.0-062016 timestamp* : string format: date-time description:Defines the date of the application terms and conditions agreeent in ISO 8601 format with a timezone [ReadOnly] } email* : string maxLength: 500 } business* : BacsGbpBusiness { The details of a BACS United Kingdom business company_name* : string maxLength: 64 annual_sales* : number format: float32 description:This is the annual sales volume in GBP. entity_type* : string Enum (9) public_limited private_limited limited_liability_partnership combination_partnership partnership sole_trader community_interest charitable_incorporated other description:This is the business entity type website_url : string format: uri maxLength: 128 legal_name* : string maxLength: 64 start_date* : string format: date-time description:This is the business start date in ISO 8601 format with a timezone registration_number : string maxLength: 32 dba_name* : string maxLength: 32 description:This is the "doing business as" name batch_settings* : BatchSettings { The details of a batch requirements frequency* : string Enum (7) daily weekly bi_weekly monthly bi_monthly semi_annually annually average_amount* : number format: float32 maximum_amount* : number format: float32 } address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } directors* : array of BacsGbpDirector { Defines a BACS United Kingdom business owner or director first_name* : string maxLength: 64 last_name* : string maxLength: 64 date_of_birth* : string format: date-time description:Defines the birthday in ISO 8601 format with a timezone start_date* : string format: date-time description:Defines the the ownership start date in ISO 8601 format with a timezone percentage : number format: float32 maximum: 100 minimum: 0 description:Defines the percentage, from 0.00 to 100.00, of the company ownership. address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } } bank_account* : UnitedKingdomBankAccount { Defines a United Kingdom bank account owner_name* : string maxLength: 64 bank_name* : string maxLength: 32 address : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } sort_code* : string pattern: ^\d{2}-?\d{2}-?\d{2}$ account_number* : string pattern: ^\d{8}$ bank_account_contact : BankAccountContact { Defines the primary contact for the bank account first_name : string maxLength: 64 description:First name of the primary contact for the bank account. last_name : string maxLength: 64 description:Last name of the primary contact for the bank account. email : string maxLength: 500 description:Email of the primary contact for the bank account. phone_number : string maxLength: 15 description:Phone number of the primary contact for the bank account. } } documents : array of BacsGbpFile { Defines a document that is required for application approval. name* : string Enum (7) copy_id void_cheque bank_statement certificate registration board_members direct_debit description:Name of the document. This will match to one of the list of possible files. This is a read-only attribute. The options are "Copy ID (Owner and/or Principal) - govt issued photo ID", "Void Check or Bank Statement", "Certificate of Incorporation (if applicable)", "Non-Profit Registration Documents (if applicable)", "List of Board Members (public and NFP companies)" and "Direct Debit Instructions" type* : string Enum (6) jpg jpeg doc docx pdf png description:File type of the document; accepted file formats. notes : string description:Description of the document and the contents that it must contain. base64* : string description:The document data, submitted as a base64 encoded string.. uri : string description:The URI that allows retrival of the documents using the GET /appplicatins/{id}/documents/{name}. [ReadOnly] } } custom_data : object description:Optional custom data, must be a JSON object. Example: {"id": 12345} } |
Code | Description | Schema |
---|---|---|
200 | Application updated | Status |
400 | Invalid request | Array of Error |
404 | Application not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
Status
{
Defines information about the application. [ReadOnly]
state
:
string
Enum
(4)
in_progress
in_review
rejected
approved
description:
The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } |
Retrieves a United Kingdom BACS application referenced by the given applicationId.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | path | applicationId | The id of the application to retrieve | string |
Code | Description | Schema |
---|---|---|
200 | Application retrieved | BacsGbpApplicationResponse |
400 | Invalid request | Array of Error |
404 | Application not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
BacsGbpApplicationResponse
{
Defines a BACS United Kingdom application
id
:
integer
description:
This application identifier is used to identify an application. It is auto-generated by the API [ReadOnly] merchant_id : integer description:This merchant identifier is populated when the application is approved and a merchant account has been associated. [ReadOnly] pricing_id* : string maxLength: 32 description:This is the reference number for the pricing package associated with an application status : StatusResponse { Defines information about the application. [ReadOnly] state : string Enum (4) in_progress in_review rejected approved description:The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] submitted_on : string format: date-time description:Defines the date when the application was put into review in ISO 8601 format with a timezone [ReadOnly] approved_on : string format: date-time description:Defines the date when the application was approved in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } applicant* : EftApplicant { The individual completing the application first_name* : string maxLength: 64 last_name* : string maxLength: 64 phone_number* : string maxLength: 15 agreement* : Agreement { Defines an terms and conditions agreement between a merchant and Beanstream name* : string description:Defines the name of the agreement. Use the application type, as is in the url: eg. PSP-CAD version* : string description:Defines the version of the agreement. Use the version number that is in the terms document file name. For example http:...com/terms/api/psp-cad-v1.0-062016.htm you would use: 1.0-062016 timestamp* : string format: date-time description:Defines the date of the application terms and conditions agreeent in ISO 8601 format with a timezone [ReadOnly] } email* : string maxLength: 500 } business* : BacsGbpBusiness { The details of a BACS United Kingdom business company_name* : string maxLength: 64 annual_sales* : number format: float32 description:This is the annual sales volume in GBP. entity_type* : string Enum (9) public_limited private_limited limited_liability_partnership combination_partnership partnership sole_trader community_interest charitable_incorporated other description:This is the business entity type website_url : string format: uri maxLength: 128 legal_name* : string maxLength: 64 start_date* : string format: date-time description:This is the business start date in ISO 8601 format with a timezone registration_number : string maxLength: 32 dba_name* : string maxLength: 32 description:This is the "doing business as" name batch_settings* : BatchSettings { The details of a batch requirements frequency* : string Enum (7) daily weekly bi_weekly monthly bi_monthly semi_annually annually average_amount* : number format: float32 maximum_amount* : number format: float32 } address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } directors* : array of BacsGbpDirector { Defines a BACS United Kingdom business owner or director first_name* : string maxLength: 64 last_name* : string maxLength: 64 date_of_birth* : string format: date-time description:Defines the birthday in ISO 8601 format with a timezone start_date* : string format: date-time description:Defines the the ownership start date in ISO 8601 format with a timezone percentage : number format: float32 maximum: 100 minimum: 0 description:Defines the percentage, from 0.00 to 100.00, of the company ownership. address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } } bank_account* : UnitedKingdomBankAccount { Defines a United Kingdom bank account owner_name* : string maxLength: 64 bank_name* : string maxLength: 32 address : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } sort_code* : string pattern: ^\d{2}-?\d{2}-?\d{2}$ account_number* : string pattern: ^\d{8}$ bank_account_contact : BankAccountContact { Defines the primary contact for the bank account first_name : string maxLength: 64 description:First name of the primary contact for the bank account. last_name : string maxLength: 64 description:Last name of the primary contact for the bank account. email : string maxLength: 500 description:Email of the primary contact for the bank account. phone_number : string maxLength: 15 description:Phone number of the primary contact for the bank account. } } documents : array of BacsGbpFile { Defines a document that is required for application approval. name* : string Enum (7) copy_id void_cheque bank_statement certificate registration board_members direct_debit description:Name of the document. This will match to one of the list of possible files. This is a read-only attribute. The options are "Copy ID (Owner and/or Principal) - govt issued photo ID", "Void Check or Bank Statement", "Certificate of Incorporation (if applicable)", "Non-Profit Registration Documents (if applicable)", "List of Board Members (public and NFP companies)" and "Direct Debit Instructions" type* : string Enum (6) jpg jpeg doc docx pdf png description:File type of the document; accepted file formats. notes : string description:Description of the document and the contents that it must contain. base64* : string description:The document data, submitted as a base64 encoded string.. uri : string description:The URI that allows retrival of the documents using the GET /appplicatins/{id}/documents/{name}. [ReadOnly] } } custom_data : object description:Optional custom data, must be a JSON object. Example: {"id": 12345} } |
Creates a United Kingdom BACS application document for the referenced applicationId. Returns the status of the application.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | path | applicationId | The id of the application to create a document in. | integer |
true | body | document | Document details | BacsGbpFile |
Parameter Schema Definitions |
---|
BacsGbpFile
{
Defines a document that is required for application approval.
name*
:
string
Enum
(7)
copy_id
void_cheque
bank_statement
certificate
registration
board_members
direct_debit
description:
Name of the document. This will match to one of the list of possible files. This is a read-only attribute. The options are "Copy ID (Owner and/or Principal) - govt issued photo ID", "Void Check or Bank Statement", "Certificate of Incorporation (if applicable)", "Non-Profit Registration Documents (if applicable)", "List of Board Members (public and NFP companies)" and "Direct Debit Instructions" type* : string Enum (6) jpg jpeg doc docx pdf png description:File type of the document; accepted file formats. notes : string description:Description of the document and the contents that it must contain. base64* : string description:The document data, submitted as a base64 encoded string.. uri : string description:The URI that allows retrival of the documents using the GET /appplicatins/{id}/documents/{name}. [ReadOnly] } |
Code | Description | Schema |
---|---|---|
200 | Document created | Status |
400 | Invalid request | Array of Error |
404 | Application not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
Status
{
Defines information about the application. [ReadOnly]
state
:
string
Enum
(4)
in_progress
in_review
rejected
approved
description:
The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } |
Deletes a United Kingdom BACS application document for the referenced applicationId and documentId. Returns the status of the application.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | path | applicationId | The id of the application to delete the document from | integer |
true | path | documentId | The name of the document to delete | string |
Code | Description | Schema |
---|---|---|
204 | Documents Updated | Status |
400 | Invalid request | Array of Error |
404 | Application or Document not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
Status
{
Defines information about the application. [ReadOnly]
state
:
string
Enum
(4)
in_progress
in_review
rejected
approved
description:
The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } |
Updates a United Kingdom BACS application status for the referenced applicationId. Returns the status of the application.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | path | applicationId | The id of the application to update status for | integer |
true | body | status | The status details | Status |
Parameter Schema Definitions |
---|
Status
{
Defines information about the application. [ReadOnly]
state
:
string
Enum
(4)
in_progress
in_review
rejected
approved
description:
The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } |
Code | Description | Schema |
---|---|---|
200 | Status Updated | Status |
400 | Invalid request | Array of Error |
404 | Application not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
Status
{
Defines information about the application. [ReadOnly]
state
:
string
Enum
(4)
in_progress
in_review
rejected
approved
description:
The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } |
Returns latest version of T&Cs doc for a United Kingdom BACS application.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | path | partner | The name of the partner, if customized T&Cs have been agreed. Pass "default" for the default version of the document. | string |
true | path | file_type | The format of the T&Cs document to be returned. | string |
Code | Description | Schema |
---|---|---|
200 | Document version info | 200 Response |
400 | Invalid request | Array of Error |
404 | Document not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
200 Response
{
Defines information about the document.
version
:
string
description:
Defines the version of the document returned. name : string format: flow/partner_date:time description:Defines the name of the document returned. } |
Retrieves T&Cs for a United Kingdom BACS application.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | path | partner | The name of the partner, if customized T&Cs have been agreed. Pass "default" for the default version of the document. | string |
true | path | file_type | The format of the T&Cs document to be returned. | string |
true | path | version | The version of the document. | string |
Code | Description | Schema |
---|---|---|
200 | Document retrieved with identifing properties in HTTP header | 200 Response |
400 | Invalid request | Array of Error |
404 | Document not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
200 Response
{
Defines information about the document. [HTTP header]
X-Version
:
string
description:
Defines the version of the document returned. X-Name : string format: flow/partner_date:time description:Defines the name of the document returned. } |
Creates a new United States ACH application. The status of the application will be returned in the status object. A Location header that points to the URL of the new resource will be available in the response. The Location header has an application ID that should be used for all future requests to that application.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | body | application | Application details | AchUsdApplicationRequest |
Parameter Schema Definitions |
---|
AchUsdApplicationRequest
{
Defines an ACH American application
id
:
integer
description:
This application identifier is used to identify an application. It is auto-generated by the API [ReadOnly] merchant_id : integer description:This merchant identifier is populated when the application is approved and a merchant account has been associated. [ReadOnly] pricing_id* : string maxLength: 32 description:This is the reference number for the pricing package associated with an application status : Status { Defines information about the application. [ReadOnly] state : string Enum (4) in_progress in_review rejected approved description:The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } applicant* : EftApplicant { The individual completing the application first_name* : string maxLength: 64 last_name* : string maxLength: 64 phone_number* : string maxLength: 15 agreement* : Agreement { Defines an terms and conditions agreement between a merchant and Beanstream name* : string description:Defines the name of the agreement. Use the application type, as is in the url: eg. PSP-CAD version* : string description:Defines the version of the agreement. Use the version number that is in the terms document file name. For example http:...com/terms/api/psp-cad-v1.0-062016.htm you would use: 1.0-062016 timestamp* : string format: date-time description:Defines the date of the application terms and conditions agreeent in ISO 8601 format with a timezone [ReadOnly] } email* : string maxLength: 500 } business* : AchUsdBusiness { The details of an ACH American business company_name* : string maxLength: 64 annual_sales* : number format: float32 description:This is the annual sales volume in USD. entity_type* : string Enum (8) sole_proprietor partnership limited_partnership joint_venture corporation non_profit publicly_traded charitable_organization description:This is the business entity type website_url : string format: uri maxLength: 128 registration_location : string maxLength: 64 start_date* : string format: date-time description:This is the business start date in ISO 8601 format with a timezone business_number : string maxLength: 32 dba_name* : string maxLength: 32 description:This is the "doing business as" name batch_settings* : BatchSettings { The details of a batch requirements frequency* : string Enum (7) daily weekly bi_weekly monthly bi_monthly semi_annually annually average_amount* : number format: float32 maximum_amount* : number format: float32 } address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } directors* : array of AchUsdDirector { Defines an ACH American business owner or director first_name* : string maxLength: 64 last_name* : string maxLength: 64 date_of_birth* : string format: date-time description:Defines the birthday in ISO 8601 format with a timezone start_date* : string format: date-time description:Defines the ownership start date in ISO 8601 format with a timezone percentage : number format: float32 maximum: 100 minimum: 0 description:Defines the percentage, from 0.00 to 100.00, of the company ownership. address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } } bank_account* : AmericanBankAccount { Defines an American bank account owner_name* : string maxLength: 64 routing_number* : string pattern: ^\d{9}$ account_number* : string pattern: ^\d{1,17}$ } documents : array of AchUsdFile { Defines a document that is required for application approval. name* : string Enum (6) copy_id void_cheque bank_statement certificate registration board_members description:Name of the document. This will match to one of the list of possible files. This is a read-only attribute. The options are "Copy ID (Owner and/or Principal) - govt issued photo ID", "Void Check or Bank Statement", "Certificate of Incorporation (if applicable)", "Non-Profit Registration Documents (if applicable)" and "List of Board Members (public and NFP companies)" type* : string Enum (6) jpg jpeg doc docx pdf png description:File type of the document; accepted file formats. notes : string description:Description of the document and the contents that it must contain. base64* : string description:The document data, submitted as a base64 encoded string.. uri : string description:The URI that allows retrival of the documents using the GET /appplicatins/{id}/documents/{name}. [ReadOnly] } } custom_data : object description:Optional custom data, must be a JSON object. Example: {"id": 12345} } |
Code | Description | Schema |
---|---|---|
201 | Application created | Status |
400 | Invalid request | Array of Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
Status
{
Defines information about the application. [ReadOnly]
state
:
string
Enum
(4)
in_progress
in_review
rejected
approved
description:
The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } |
Retrieves all United States ACH applications referenced by the given criteria in the url. A search criteria can be a combination of the following: - state={state} - Accepted values are "in_progress", "in_review", "on_hold", "approved" "rejected", "live" and "temp_disabled" - createdbefore={date} - createdafter={date} - updatedbefore={date} - updatedafter={date}
Documents file data will be excluded to limit the amount of data on the wire.
No parameters
Code | Description | Schema |
---|---|---|
200 | Application(s) retrieved | Array of AchUsdApplicationRequest |
400 | Invalid request | Array of Error |
404 | Applications not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
AchUsdApplicationRequest
{
Defines an ACH American application
id
:
integer
description:
This application identifier is used to identify an application. It is auto-generated by the API [ReadOnly] merchant_id : integer description:This merchant identifier is populated when the application is approved and a merchant account has been associated. [ReadOnly] pricing_id* : string maxLength: 32 description:This is the reference number for the pricing package associated with an application status : Status { Defines information about the application. [ReadOnly] state : string Enum (4) in_progress in_review rejected approved description:The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } applicant* : EftApplicant { The individual completing the application first_name* : string maxLength: 64 last_name* : string maxLength: 64 phone_number* : string maxLength: 15 agreement* : Agreement { Defines an terms and conditions agreement between a merchant and Beanstream name* : string description:Defines the name of the agreement. Use the application type, as is in the url: eg. PSP-CAD version* : string description:Defines the version of the agreement. Use the version number that is in the terms document file name. For example http:...com/terms/api/psp-cad-v1.0-062016.htm you would use: 1.0-062016 timestamp* : string format: date-time description:Defines the date of the application terms and conditions agreeent in ISO 8601 format with a timezone [ReadOnly] } email* : string maxLength: 500 } business* : AchUsdBusiness { The details of an ACH American business company_name* : string maxLength: 64 annual_sales* : number format: float32 description:This is the annual sales volume in USD. entity_type* : string Enum (8) sole_proprietor partnership limited_partnership joint_venture corporation non_profit publicly_traded charitable_organization description:This is the business entity type website_url : string format: uri maxLength: 128 registration_location : string maxLength: 64 start_date* : string format: date-time description:This is the business start date in ISO 8601 format with a timezone business_number : string maxLength: 32 dba_name* : string maxLength: 32 description:This is the "doing business as" name batch_settings* : BatchSettings { The details of a batch requirements frequency* : string Enum (7) daily weekly bi_weekly monthly bi_monthly semi_annually annually average_amount* : number format: float32 maximum_amount* : number format: float32 } address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } directors* : array of AchUsdDirector { Defines an ACH American business owner or director first_name* : string maxLength: 64 last_name* : string maxLength: 64 date_of_birth* : string format: date-time description:Defines the birthday in ISO 8601 format with a timezone start_date* : string format: date-time description:Defines the ownership start date in ISO 8601 format with a timezone percentage : number format: float32 maximum: 100 minimum: 0 description:Defines the percentage, from 0.00 to 100.00, of the company ownership. address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } } bank_account* : AmericanBankAccount { Defines an American bank account owner_name* : string maxLength: 64 routing_number* : string pattern: ^\d{9}$ account_number* : string pattern: ^\d{1,17}$ } documents : array of AchUsdFile { Defines a document that is required for application approval. name* : string Enum (6) copy_id void_cheque bank_statement certificate registration board_members description:Name of the document. This will match to one of the list of possible files. This is a read-only attribute. The options are "Copy ID (Owner and/or Principal) - govt issued photo ID", "Void Check or Bank Statement", "Certificate of Incorporation (if applicable)", "Non-Profit Registration Documents (if applicable)" and "List of Board Members (public and NFP companies)" type* : string Enum (6) jpg jpeg doc docx pdf png description:File type of the document; accepted file formats. notes : string description:Description of the document and the contents that it must contain. base64* : string description:The document data, submitted as a base64 encoded string.. uri : string description:The URI that allows retrival of the documents using the GET /appplicatins/{id}/documents/{name}. [ReadOnly] } } custom_data : object description:Optional custom data, must be a JSON object. Example: {"id": 12345} } |
Updates a United States ACH application referenced by the given applicationId.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | path | applicationId | The id of the application to update | integer |
true | body | application | Applicaiton details | AchUsdApplicationRequest |
Parameter Schema Definitions |
---|
AchUsdApplicationRequest
{
Defines an ACH American application
id
:
integer
description:
This application identifier is used to identify an application. It is auto-generated by the API [ReadOnly] merchant_id : integer description:This merchant identifier is populated when the application is approved and a merchant account has been associated. [ReadOnly] pricing_id* : string maxLength: 32 description:This is the reference number for the pricing package associated with an application status : Status { Defines information about the application. [ReadOnly] state : string Enum (4) in_progress in_review rejected approved description:The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } applicant* : EftApplicant { The individual completing the application first_name* : string maxLength: 64 last_name* : string maxLength: 64 phone_number* : string maxLength: 15 agreement* : Agreement { Defines an terms and conditions agreement between a merchant and Beanstream name* : string description:Defines the name of the agreement. Use the application type, as is in the url: eg. PSP-CAD version* : string description:Defines the version of the agreement. Use the version number that is in the terms document file name. For example http:...com/terms/api/psp-cad-v1.0-062016.htm you would use: 1.0-062016 timestamp* : string format: date-time description:Defines the date of the application terms and conditions agreeent in ISO 8601 format with a timezone [ReadOnly] } email* : string maxLength: 500 } business* : AchUsdBusiness { The details of an ACH American business company_name* : string maxLength: 64 annual_sales* : number format: float32 description:This is the annual sales volume in USD. entity_type* : string Enum (8) sole_proprietor partnership limited_partnership joint_venture corporation non_profit publicly_traded charitable_organization description:This is the business entity type website_url : string format: uri maxLength: 128 registration_location : string maxLength: 64 start_date* : string format: date-time description:This is the business start date in ISO 8601 format with a timezone business_number : string maxLength: 32 dba_name* : string maxLength: 32 description:This is the "doing business as" name batch_settings* : BatchSettings { The details of a batch requirements frequency* : string Enum (7) daily weekly bi_weekly monthly bi_monthly semi_annually annually average_amount* : number format: float32 maximum_amount* : number format: float32 } address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } directors* : array of AchUsdDirector { Defines an ACH American business owner or director first_name* : string maxLength: 64 last_name* : string maxLength: 64 date_of_birth* : string format: date-time description:Defines the birthday in ISO 8601 format with a timezone start_date* : string format: date-time description:Defines the ownership start date in ISO 8601 format with a timezone percentage : number format: float32 maximum: 100 minimum: 0 description:Defines the percentage, from 0.00 to 100.00, of the company ownership. address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } } bank_account* : AmericanBankAccount { Defines an American bank account owner_name* : string maxLength: 64 routing_number* : string pattern: ^\d{9}$ account_number* : string pattern: ^\d{1,17}$ } documents : array of AchUsdFile { Defines a document that is required for application approval. name* : string Enum (6) copy_id void_cheque bank_statement certificate registration board_members description:Name of the document. This will match to one of the list of possible files. This is a read-only attribute. The options are "Copy ID (Owner and/or Principal) - govt issued photo ID", "Void Check or Bank Statement", "Certificate of Incorporation (if applicable)", "Non-Profit Registration Documents (if applicable)" and "List of Board Members (public and NFP companies)" type* : string Enum (6) jpg jpeg doc docx pdf png description:File type of the document; accepted file formats. notes : string description:Description of the document and the contents that it must contain. base64* : string description:The document data, submitted as a base64 encoded string.. uri : string description:The URI that allows retrival of the documents using the GET /appplicatins/{id}/documents/{name}. [ReadOnly] } } custom_data : object description:Optional custom data, must be a JSON object. Example: {"id": 12345} } |
Code | Description | Schema |
---|---|---|
200 | Application updated | Status |
400 | Invalid request | Array of Error |
404 | Application not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
Status
{
Defines information about the application. [ReadOnly]
state
:
string
Enum
(4)
in_progress
in_review
rejected
approved
description:
The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } |
Retrieves a United States ACH application referenced by the given applicationId.
Required | In | Name | Description | Schema |
---|---|---|---|---|
true | path | applicationId | The id of the application to retrieve | string |
Code | Description | Schema |
---|---|---|
200 | Application retrieved | AchUsdApplicationResponse |
400 | Invalid request | Array of Error |
404 | Application not found | Error |
500 | Unexpected error | Error |
Response Schema Definitions |
---|
AchUsdApplicationResponse
{
Defines an ACH American application
id
:
integer
description: This application identifier is used to identify an application. It is auto-generated by the API [ReadOnly] merchant_id : integer description:This merchant identifier is populated when the application is approved and a merchant account has been associated. [ReadOnly] pricing_id* : string maxLength: 32 description:This is the reference number for the pricing package associated with an application status : StatusResponse { Defines information about the application. [ReadOnly] state : string Enum (4) in_progress in_review rejected approved description:The state of the application. Possible values are "inprogress", "inreview", "rejected", "approved" created_on : string format: date-time description:Defines the date when the application was created in ISO 8601 format with a timezone [ReadOnly] updated_on : string format: date-time description:Defines the date when the application was modified in ISO 8601 format with a timezone [ReadOnly] submitted_on : string format: date-time description:Defines the date when the application was put into review in ISO 8601 format with a timezone [ReadOnly] approved_on : string format: date-time description:Defines the date when the application was approved in ISO 8601 format with a timezone [ReadOnly] pending_issues : array of Error { Defines an error field : string description:A field associated with the error code : string description:A code associated with the error } } applicant* : EftApplicant { The individual completing the application first_name* : string maxLength: 64 last_name* : string maxLength: 64 phone_number* : string maxLength: 15 agreement* : Agreement { Defines an terms and conditions agreement between a merchant and Beanstream name* : string description:Defines the name of the agreement. Use the application type, as is in the url: eg. PSP-CAD version* : string description:Defines the version of the agreement. Use the version number that is in the terms document file name. For example http:...com/terms/api/psp-cad-v1.0-062016.htm you would use: 1.0-062016 timestamp* : string format: date-time description:Defines the date of the application terms and conditions agreeent in ISO 8601 format with a timezone [ReadOnly] } email* : string maxLength: 500 } business* : AchUsdBusiness { The details of an ACH American business company_name* : string maxLength: 64 annual_sales* : number format: float32 description:This is the annual sales volume in USD. entity_type* : string Enum (8) sole_proprietor partnership limited_partnership joint_venture corporation non_profit publicly_traded charitable_organization description:This is the business entity type website_url : string format: uri maxLength: 128 registration_location : string maxLength: 64 start_date* : string format: date-time description:This is the business start date in ISO 8601 format with a timezone business_number : string maxLength: 32 dba_name* : string maxLength: 32 description:This is the "doing business as" name batch_settings* : BatchSettings { The details of a batch requirements frequency* : string Enum (7) daily weekly bi_weekly monthly bi_monthly semi_annually annually average_amount* : number format: float32 maximum_amount* : number format: float32 } address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW description:Valid ISO 3166-1 country code for US, CA, GB, or a European country postal_code : string maxLength: 7 description:Postal/Zip code } directors* : array of AchUsdDirector { Defines an ACH American business owner or director first_name* : string maxLength: 64 last_name* : string maxLength: 64 date_of_birth* : string format: date-time description:Defines the birthday in ISO 8601 format with a timezone start_date* : string format: date-time description:Defines the ownership start date in ISO 8601 format with a timezone percentage : number format: float32 maximum: 100 minimum: 0 description:Defines the percentage, from 0.00 to 100.00, of the company ownership. address* : Address { Defines a generic address address_line1* : string maxLength: 64 address_line2 : string maxLength: 64 city* : string maxLength: 64 region : string maxLength: 64 description:State/Province/Municipality/Region country* : string Enum (249) AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG |