# Ratepay Merchant Registration API

The Ratepay Merchant Registration API allows a fast, easy and automatable registration process for new shops.<br />After a successful registration shops should be able to use all configured payment methods for used partner profile-id.

Version: 2.0

## Servers

Production environment
```
https://api.ratepay.com/merchant/registry
```

Test environment
```
https://api-integration.ratepay.com/merchant/registry
```

## Security

### Bearer Authentication

For each request, a valid access token must be provided in the Authorization header. See [Authentication API](/docs/developer/authentication/authentication/) for obtaining a valid token.

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[Ratepay Merchant Registration API](https://docs.ratepay.com/_bundle/docs/developer/psps_and_marketplaces/interfaces/merchant_registration_api/operations.yaml)

## Other

### Register shop

 - [POST /v2/partners/{partner_profile_id}/shops](https://docs.ratepay.com/docs/developer/psps_and_marketplaces/interfaces/merchant_registration_api/operations/other/registershop.md): Register a new shops into Ratepay system. It is mandatory to register the shop before submitting payment requests.

### Retrieve Shop

 - [GET /v2/partners/{partner_profile_id}/shops/{shop_id}](https://docs.ratepay.com/docs/developer/psps_and_marketplaces/interfaces/merchant_registration_api/operations/other/retrieveshop.md): This Endpoint will output the stored information for the shop_id

### Update Shop

 - [PUT /v2/partners/{partner_profile_id}/shops/{shop_id}](https://docs.ratepay.com/docs/developer/psps_and_marketplaces/interfaces/merchant_registration_api/operations/other/updateshop.md): This API endpoint will replace the configuration stored for the shop by the new one passed here

### Upload Shop Logo

 - [POST /v2/partners/{partner_profile_id}/shops/{shop_id}/logos](https://docs.ratepay.com/docs/developer/psps_and_marketplaces/interfaces/merchant_registration_api/operations/other/uploadshoplogo.md): Use this endpoint for uploading a shop logo, which will we placed on the correspondencesConstraints for the logo fileRequirements for the image file:- The logo file should not exceed 150 KB.- Recommended resolution > 300 dpi- The logo file format should be png.- The background should be transparent.- The logo should be in a horizontal design (width >= height).Visualization rules:- proportion-rule: It will be always proportionally stretched.- max-height rule: The max-height of visualization will be 100px.- It will be visualized in a width between 250 and 500px, if the height and proportion rules allow it.- It will be placed on the top of the correspondence.