SIP

Rail overview

Use SIP for interoperable instant pay-ins across Peru and Bolivia.

The payer completes the payment through their local interoperable network; Conomy receives confirmation and advances the payment lifecycle.

Region Peru · Bolivia

Currency PEN · BOB

Direction Pay-in

Model Interoperable payment system

Match the currency to the payer's country before initiating the payment to avoid routing failures.

SIP (Sistema de Pagos Interoperables) is an interoperable payment rail available in Peru (PEN) and Bolivia (BOB). The flow uses a redirect: the platform returns a URL and the payer completes the payment on their bank’s interface.

Required fields

Field	Type	Description
type	string	Must be "SIP"
currency	string	"PEN" for Peru or "BOB" for Bolivia
sip.customer.firstName	string	Payer’s first name
sip.customer.lastName	string	Payer’s last name
sip.customer.documentNumber	string	Payer’s document number
sip.customer.documentType	string	Document type (e.g. "DNI", "CI")
sip.customer.email	string	Payer’s email

Optional fields

Field	Type	Description
sip.successUrl	string	URL to redirect after successful payment
sip.failedUrl	string	URL to redirect if payment fails

Example

{
  "type": "SIP",
  "currency": "PEN",
  "sip": {
    "successUrl": "https://yourapp.com/success",
    "failedUrl": "https://yourapp.com/failed",
    "customer": {
      "firstName": "Ana",
      "lastName": "Flores",
      "documentType": "DNI",
      "documentNumber": "87654321",
      "email": "ana@example.com"
    }
  }
}

Response fields

Field	Description
url	Redirect URL — send the user here to complete the payment

Redirect your user to sip.url immediately after creating the payment.

Valid destinations

Node	Description
ACCOUNT	Internal platform account

Object