# Integration overview

Before the Go live...

- **Contractual agreements** have to be done,
- **Tests** and **Invoicing** must be checked & approved by Ratepay!


## Transaction flow

Transaction flow
## Test / Integration phase

### Logins / credentials

- Get test credentials from your Ratepay representative
- Set up your test environment
- [Give your team members access to ORCA test environment](/docs/orca/english_version/user_management/user_management)


### Technical integration

#### Frontend

- Show Ratepay payment method(s) in your checkout (Optional: Logos can be found [here](/docs/logos/ratepay_logos/))
- Display [Ratepay's legal requirements in your checkout & GTC](/docs/legal/a_legal_requirements_for_the_integration/basic_integration)
- If not already requested in your checkout: Implement fields for...
  - B2C: Name of customer, addresses, e-mail, date of birth, telephone number
  - B2B: Company name, addresses, e-mail, VAT ID
  - Payment method "SEPA Direct Debit": Bank account owner & IBAN
- Implement [Device Fingerprinting](/docs/developer/device_fingerprinting/device_fingerprinting/) for online shop orders
- For SEPA Direct Debit:
  - [Request SEPA mandate from buyer](/docs/legal/a_legal_requirements_for_the_integration/sepa_integration/sepa_mandate_text)
- For One Time Passcode (OTP) if contractually agreed:
  - Implement the user interface for One Time Passcode (OTP) screens


#### Backend

- [OAuth token handling (via Authentication API)](/docs/developer/authentication/authentication/)
- Optional, but recommended to ensure data consistency: [Idempotency handling](/docs/developer/api_integration/payment_2.0/idempotency/)
- [Perform transaction with buyer- & shopping basket data (Authorize transaction)](/apis/payment/openapi/payment_api/transaction-management/createtransaction)
- Handle [successful transaction / errors / rejections](/docs/developer/api_integration/payment_2.0/declines/decline_categories/) and show it in frontend
- For One Time Passcode (OTP) if contractually agreed:
  - Implement OTP endpoints and connect them with the frontend screens for OTP entry and regeneration
- Forward [ratepay_transaction_id](/apis/payment/openapi/payment_api/transaction-management/createtransaction#tag/Transaction-management/operation/createTransaction!c=201&path=ratepay_transaction_id&t=response) for followup operations & [ratepay_payment_reference](/apis/payment/openapi/payment_api/transaction-management/createtransaction#tag/Transaction-management/operation/createTransaction!c=201&path=payment_details/ratepay_payment_references/ratepay_payment_reference&t=response) for Invoicing to ERP
- Implement followup operations (e. g. in ERP):
  - [Capture transaction](/apis/payment/openapi/payment_api/capture/capturetransaction/)
  - [Incremental authorize transaction](/apis/payment/openapi/payment_api/incremental-authorization/incrementalauthorizationtransaction)
  - [Cancel transaction](/apis/payment/openapi/payment_api/cancellation/canceltransaction)
  - [Refund transaction](/apis/payment/openapi/payment_api/refund/refundtransaction)


#### General

- [Do the Testing](/docs/developer/testing/testing)
- [Create or adjust the invoicing document for the buyer](/docs/legal/a_legal_requirements_for_the_integration/customer_correspondences/customer_correspondences)
- Optional & if contractually agreed: [Submit Regular Customers](/docs/reporting/regular_customers/regular_customers_introduction/)
- Optional & if contractually agreed: [Implement Transaction Status API](/docs/developer/transaction_status/introduction/)


## Live

### Logins / credentials

- Get live credentials from your Ratepay representative
- Set up your live environment
- [Give your team members access to ORCA live environment](/docs/orca/english_version/user_management/user_management)


### Finance

- [Settlement files](/docs/reporting/settlement/overview)
- [Clearing files](/docs/reporting/clearing/clearing_files)