{"info":{"_postman_id":"b5dc583e-9043-4e9b-8f77-b001cfdd2727","name":"Cross Border Payments Api","description":"

Introduction:

B89 Payments is a leading online payment and collection intermediation company, dedicated to facilitating seamless cross-border transactions. Our flagship product, B89 Payments, serves as a comprehensive solution for both payins and payouts, providing consumers with diverse payment methods and empowering businesses with efficient avenues for conducting large-scale transactions.

Cross-Border Payments:
B89 Payments specializes in facilitating secure and efficient cross-border transactions. Whether you are making payins or payouts, our platform ensures a streamlined process for hassle-free international transactions.
\n
Diverse Payment Methods:
We understand the importance of flexibility in payment options. B89 Payments offers a wide range of payment methods, providing consumers with the freedom to choose the option that best suits their needs.
\n
Efficiency for Businesses:
For businesses, B89 Payments is a reliable partner, offering efficient ways to handle massive payments. Our platform is designed to optimize transaction processes, allowing businesses to focus on their core operations while ensuring a secure and reliable payment experience.
\n

How B89 Payments Works:

Payins:
B89 Payments simplifies the process of receiving payments across borders. Whether it's from customers or partners, our platform ensures a swift and secure payin process, minimizing complexities associated with international transactions.

Security and Reliability:

At B89 Payments, we prioritize the security and reliability of every transaction. Our robust security measures and advanced encryption technologies safeguard your financial data, ensuring a trustworthy payment environment.

Getting Started:

To begin utilizing B89 Payments for your cross-border payment needs, refer to our comprehensive documentation and guides. Whether you are an individual seeking convenient payin options or a business looking to optimize payouts, our documentation will guide you through the process step by step.

Contact Us:

For any inquiries or assistance, feel free to reach out to our dedicated support team. We are committed to providing exceptional service and ensuring that your experience with B89 Payments is smooth and satisfactory.

Thank you for choosing B89 Payments for your cross-border payment solutions!

Please leave us your information so we can contact you:

https://forms.office.com/r/u8qPqpCUks

Glossary:

API (Application Programming Interface): A set of rules and tools that allows different software systems to communicate with each other.

International payout: A transfer of money from one country to another, usually made by migrant workers to send money to family members in their home countries.

Payout provider: An entity that offers international money transfer services. It may be a bank, a non-bank financial institution, an online payment platform, or others.

Authentication: The process of verifying the identity of a user or application accessing the API. It may involve the use of access tokens, API keys or other authentication mechanisms.

Authorization: Process that determines what actions and resources a user or application can perform or access once they have been authenticated.

Endpoint: An API endpoint to which requests can be sent to perform certain actions, such as sending a payout, checking the status of a transaction, etc.

Request: A message sent through the API to perform a specific action, such as sending money or inquiring about a transaction.

Response: Message returned by the API after receiving and processing a request. It may contain transaction data, status codes, error messages, etc.

Webhook: A mechanism by which an application can automatically send data to another application when a request is received and processed.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"33018440","collectionId":"b5dc583e-9043-4e9b-8f77-b001cfdd2727","publishedId":"2sA2r7zNjN","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"9b9b9b"},"publishDate":"2026-02-18T14:52:50.000Z"},"item":[{"name":"Merchant Utils","item":[{"name":"Sign Request","id":"991b0ec3-1312-4df5-ba50-dab9a64df56d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"secretKey\": \"{{secretKey}}\",\r\n \"privateKey\": \"{{privateKey}}\",\r\n \"queryString\": {},\r\n \"body\": {\r\n \"receivingCurrency\": \"USD\",\r\n \"sendingAmount\": 100,\r\n \"sendingCountry\": \"PER\",\r\n \"sendingCurrency\": \"PEN\",\r\n \"receivingCountry\": \"URY\",\r\n \"sendingMethod\": \"BANK_TRANSFER_PER-PEN\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/merchants/v1/sign","description":"

The B89 services require signature authentication, you can use this endpoint that helps you build the signature and timestamp required in the other API services.

Request Body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
secretKey	string	true	Merchant's secret key
privateKey	string	true	Merchant's private cert key
queryString	string	true	If the request had a query vs path params, these must go here otherwise an empty object must be sent
body	string	true	If the request had a body, they must go here, otherwise an empty object must be sent.

Response 200

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
timestamp	number	Timestamp of when the signature was created. This is valid for 1 minute
signature	string	Signature generated
queryString	string	unused.
body	Object	unused.

","urlObject":{"path":["merchants","v1","sign"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"b3c78581-76cb-4c13-9cd1-4a1542fe6b59","name":"Sign Request - 200","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"secretKey\": \"cd7b1336-885b-4581-8038-02e822e20778\",\r\n \"privateKey\": \"-----BEGIN ENCRYPTED PRIVATE KEY-----\\r\\n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\\r\\nUmGVHtM/iAKWijcsjWIc+DiUZw==\\r\\n-----END ENCRYPTED PRIVATE KEY-----\\r\\n\",\r\n \"queryString\": {},\r\n \"body\": {\r\n \"receivingCurrency\": \"USD\",\r\n \"sendingAmount\": 100,\r\n \"sendingCountry\": \"PER\",\r\n \"sendingCurrency\": \"PEN\",\r\n \"receivingCountry\": \"URY\",\r\n \"sendingMethod\": \"BANK_TRANSFER_PER-PEN\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/merchants/v1/sign"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"queryString\": \"\",\n \"body\": {},\n \"timestamp\": \"1718638635238\",\n \"signature\": \"QxFzPKmBuXNJsFizeCfshmwo3Lo5fJs5hzZOn3Mwr1wkpUGxQ+2w2eWli/7x/s0/+onjPK8SkaUaDv7RbYS9aQ0rrsXX6PAiECBbDyjL7ApIRl+dFkzeHbUZx51WdUpqivtfcljj5acTip3fd41EYncO5eN6/Sqk1InWtToZAA9NtjtZZEyqLEcwRWvGykhr9gzPxeyp4zd+hF0zL9x5tcmQ04eCD4/impvAjrVi6jI82Oge342HeeEJKBlbXuRu60N2+UtXmUx0OBt4hTUJ0+IeCCL5FQ0qNBm0/iYt6Sa59U5+SRmRvlcn48dQS/mpLrMIAue8wQV46/T05BoTnYlIpEZGdHIYZ4RE5h+hbRw2Ak8s8MenepYaMc4GZuPjnutus8NSfXmnN+UIXyY5JB1ahTRvRj7GamoMCjkUe0qMaValIgN2s8Qtwz/EEcbVcRQOw1ctnEubRI5Aw2kU8x4DtCHYJ/DFF+tVH0RvqBhTNlxX1+hbfE2J3a/Uu+SkH76AXduE/O1y/vnlAm64renRAOmbG/JXuKrLsfKciPoaUm/gkYM5RDxqlf3zr3dDMYlSmXQJNhUqYBTsfXgyyQfDbNL5BukOfA4CLECZrXxKYvwan8pCmbmVyEW80JCf2TG40J0ecy/9KaW54V9x43Z4nizh4OEisvm8FfOpx/M=\"\n}"}],"_postman_id":"991b0ec3-1312-4df5-ba50-dab9a64df56d"}],"id":"7015b2ff-2a54-4723-ac40-decc1a43afa1","description":"

Ensure you possess an RSA private key and a secret key provided by B89.
Utilize a cryptography library or module that supports RSA and SHA-256 in your chosen programming language. Incorporate a library or module to handle Base64 encoding.

\n\n

To create the signature you have two options:

You can use our utility for its generation:
\n
- Sign Request
\n
You can do your own implementation:
\n
- Section below ⬇️
\n

Steps for Signature Creation

Data Preparation:

Gather all necessary parameters for the request, including operation-specific data and a timestamp.
\n
Sort all parameters alphabetically by key.
te key.
Encode the signature in Base64.
\n

Conceptual Example (Pseudocode)

Prepare data\ndata = collectData()\nsortedData = sortAlphabetically(data)\nBuild data string\ndataString = buildDataString(sortedData)\nSign data\nprivateKeyRSA = decryptPrivateKey(privateKey, secretKey)\nhashSummary = createSHA256Summary(dataString)\nsignature = signSummary(hashSummary, privateKeyRSA)\nbase64Signature = encodeBase64(signature)\n\n

Nodejs Example

import forge from 'node-forge';\nimport * as querystring from 'querystring';\nasync function merchantSign( privateKey, secretKey, queryString, body) {\n    const timestamp = String(new Date().getTime());\n    const privateKeyInstance = forge.pki.decryptRsaPrivateKey(privateKey, secretKey);\n    const dataToSign = orderParams({ ...queryString, ...body, timestamp });\n    const md = forge.md.sha256.create();\n    md.update(dataToSign, 'utf8');\n    const signature = privateKeyInstance.sign(md);\n    const signatureBase64 = forge.util.encode64(signature);\n    return {\n        timestamp,\n        signature: signatureBase64\n    };\n}\n// Uso\nconst { timestamp, signature } = merchantSign(\"RSA_KEY\", \"secret_key\", {quoteID: \"123\"}, {})\n\n

After completing the signing steps, the merchant will have the required values that they will need in the headers of each future request:

Signature (X-Request-Signature)

Timestamp (X-Request-Timestamp)
Public Key (X-Request-PublicKey) (provided by B89).

Signature creation usage

Example of signature creation usage for querying remittance endpoints.

","_postman_id":"7015b2ff-2a54-4723-ac40-decc1a43afa1"},{"name":"Payout","item":[{"name":"Create Quote","event":[{"listen":"prerequest","script":{"id":"09d5d15c-cd2d-45f2-9cba-4987d71f821d","exec":["var requestDetails = {\r"," url: pm.environment.get(\"url\") + \"/merchants/v1/sign\",\r"," method: 'POST',\r"," header: 'Content-Type:application/json',\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," secretKey: pm.environment.get(\"secretKey\"),\r"," privateKey: pm.environment.get(\"certPrivateKey\"),\r"," queryString: {},\r"," body: JSON.parse(pm.variables.replaceIn(pm.request.body.raw))\r"," })\r"," }\r","};\r","\r","pm.sendRequest(requestDetails, function (err, response) {\r"," if (err) {\r"," console.log(err);\r"," } else {\r"," var responseData = response.json();\r"," console.log(responseData);\r"," var timestamp = responseData.timestamp;\r"," var signature = responseData.signature;\r","\r"," pm.environment.set(\"timestamp\", timestamp);\r"," pm.environment.set(\"signature\", signature);\r"," }\r","});"],"type":"text/javascript","packages":{}}}],"id":"35c4c926-a3e6-4f33-b15e-49e70752788f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Request-Signature","value":"{{signature}}","description":"

Signature Request

\n","type":"text"},{"key":"X-Request-Timestamp","value":"{{timestamp}}","description":"

Timestamp

\n","type":"text"},{"key":"X-Request-publicKey","value":"{{publicKey}}","description":"

B2B Public Key

\n","type":"text"}],"body":{"mode":"raw","raw":"{\n \"receivingCurrency\": \"USD\",\n \"sendingAmount\": 100,\n \"sendingCountry\": \"PER\",\n \"sendingCurrency\": \"PEN\",\n \"receivingCountry\": \"URY\",\n \"sendingMethod\": \"BANK_TRANSFER_PER-PEN\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/remittance/orders/v1/quotes","description":"

With this endpoint the B2B client can be create a quote

Request Body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
receivingCurrency	string	true	Type of currency in ISO 4217 that B89 will receive from the B2B client. Example: USD.
sendingAmount	number	true	Amount of money that you want the beneficiary to receive.
sendingCountry	string	true	Country where the beneficiary of the payout is located. ISO 3166-1 alfa-3. Example: BRA
sendingCurrency	string	true	Type of currency in ISO 4217 that you want the beneficiary of the payout to receive. Example: PEN , BRL.
receivingCountry	string	true	Country where the payout comes from. ISO 3166-1 alfa-3.
sendingMethod	string	true	Payout sending Method. Can be obtained from the Get Service Methods service. Ejem: BANK_TRANSFER_PER-PEN, BANK_TRANSFER_BRA-BRL, WALLET_BRA-BRL

Response 200

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
id	string	Unique identifier of the Quote.
sendingCurrency	string	Type of currency in ISO 4217 that you want the beneficiary of the payout to receive. Example: PEN.
sendingAmount	number	Amount of money that you want the beneficiary to receive.
sendingCountry	string	Country where the beneficiary of the payout is located. ISO 3166-1 alfa-3.
receivingAmount	number	Amount of money that the B2B client will pay to B89 to send the payout.
receivingCurrency	string	Type of currency in ISO 4217 that B89 will receive from the B2B client. Example: USD.
receivingCountry	string	Country where the payout comes from. ISO 3166-1 alfa-3.
merchantId	string	Unique identifier of the B2B client.
exchangeRate	number	The exchange rate that will be used to send the payout.
sendingMethod	string	Payout sending Method.
createdDatetime	string	Quote creation date and time.
expirationDatetime	string	Date and time limit in which the Quote is valid.
status	string	status in which the Quote is (PENDING, EXPIRED, CONFIRMED).

Responses Error

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Response
400	{\"type\": \"CreateQuoteBadRequestError\"}
401	{\"type\": \"ValidationMerchantInvalidTimestampError\"}
401	{\"type\": \"ValidationMerchantCredentialsDoesntMatchError\"}
401	{\"type\":\"ValidationMerchantUnauthorizedError\"}
500	{\"message\":\"An unexpected error occurred.\"}

","urlObject":{"path":["remittance","orders","v1","quotes"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"82bc18f1-e486-4188-959e-0e283957afbd","name":"Create Quote - 200","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"{{createQuoteSignature}}","description":"Signature Request","type":"text"},{"key":"X-Request-Timestamp","value":"{{createQuoteTimestamp}}","description":"Timestamp","type":"text"},{"key":"X-Request-publicKey","value":"{{publicKey}}","description":"B2B Public Key","type":"text"}],"body":{"mode":"raw","raw":"{\n \"receivingCurrency\": \"USD\",\n \"sendingAmount\": 100,\n \"sendingCountry\": \"PER\",\n \"sendingCurrency\": \"PEN\",\n \"receivingCountry\": \"URY\",\n \"sendingMethod\": \"BANK_TRANSFER_PER-PEN\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/remittance/orders/v1/quotes"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"id\": \"7ee38dbb-033a-11ef-950f-0242ac120014\",\n \"receivingCurrency\": \"USD\",\n \"sendingCurrency\": \"PEN\",\n \"sendingAmount\": 100,\n \"receivingAmount\": 26.9542,\n \"receivingCountry\": \"URY\",\n \"sendingCountry\": \"PER\",\n \"merchantId\": \"0d97de64-3bbb-4fe2-8e78-6ba22a005514\",\n \"exchangeRate\": 3.71,\n \"sendingMethod\": \"BANK_TRANSFER_PER-PEN\",\n \"createdDatetime\": \"2024-04-25 14:32:04\",\n \"expirationDatetime\": \"2024-04-25 15:32:04\",\n \"status\": \"PENDING\"\n }\n}"},{"id":"d582a4e0-606c-4600-9201-3a8f97ff4b6f","name":"404 Error","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"","description":"Signature Request","type":"text"},{"key":"X-Request-Timestamp","value":"","description":"Timestamp","type":"text"},{"key":"X-Request-publicKey","value":"","description":"B2B Public Key","type":"text"}],"body":{"mode":"raw","raw":"{\n \"receivingCurrency\": \"USD\",\n \"sendingAmount\": 500,\n \"sendingCountry\": \"PER\",\n \"sendingCurrency\": \"PEN\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/remittance/orders/v1/quote"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 16 Feb 2024 22:50:21 GMT"},{"key":"X-Request-Id","value":"69ac09e8-a303-487d-9fd4-05a5d771a933"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"MoleculerError\",\n \"message\": \"There is no merchant associated with the public key.\",\n \"code\": 404,\n \"type\": \"ValidationMerchantPublicKeyNotExistError\"\n}"}],"_postman_id":"35c4c926-a3e6-4f33-b15e-49e70752788f"},{"name":"Accept Quote","event":[{"listen":"prerequest","script":{"id":"62cba6f9-ec2d-4380-acce-9834e30706d8","exec":["var requestDetails = {\r"," url: pm.environment.get(\"url\") + \"/merchants/v1/sign\",\r"," method: 'POST',\r"," header: 'Content-Type:application/json',\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," secretKey: pm.environment.get(\"secretKey\"),\r"," privateKey: pm.environment.get(\"certPrivateKey\"),\r"," queryString: {},\r"," body: JSON.parse(pm.variables.replaceIn(pm.request.body.raw))\r"," })\r"," }\r","};\r","\r","pm.sendRequest(requestDetails, function (err, response) {\r"," if (err) {\r"," console.log(err);\r"," } else {\r"," var responseData = response.json();\r"," console.log(responseData);\r"," var timestamp = responseData.timestamp;\r"," var signature = responseData.signature;\r","\r"," pm.environment.set(\"timestamp\", timestamp);\r"," pm.environment.set(\"signature\", signature);\r"," }\r","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"ad4ad0f9-df43-4ea3-901d-cca394c85f37","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Request-Signature","value":"{{signature}}","description":"

Signature Request

\n","type":"text"},{"key":"X-Request-Timestamp","value":"{{timestamp}}","description":"

Timestamp

\n","type":"text"},{"key":"X-Request-publicKey","value":"{{publicKey}}","description":"

B2B Public Key

\n","type":"text"}],"body":{"mode":"raw","raw":"{\n \"quoteId\": \"8ae4697d-dcdc-11ee-9e60-0242ac120008\",\n \"referenceOrderId\": \"2b48d07d-3c7e-404a-a4c9-05f5a29b7cb9\",\n \"customer\": {\n \"firstName\": \"Enzo\",\n \"middleName\": \"Israel\",\n \"lastName\": \"Neyra\",\n \"secondLastName\": \"Dianderas\",\n \"city\": \"Cercado de Lima\",\n \"address\": \"Av. Mariano Cornejo 1848\",\n \"phone\": \"989218865\",\n \"documentType\": 1,\n \"documentNumber\": \"87654321\"\n },\n \"beneficiary\": {\n \"firstName\": \"Melissa\",\n \"lastName\": \"Neyra\",\n \"secondLastName\": \"Dianderas\",\n \"city\": \"SMP\",\n \"address\": \"calle jerusalen 108\",\n \"phone\": \"987654321\",\n \"documentType\": 1,\n \"documentNumber\": \"87654320\"\n },\n \"beneficiaryBankInfo\": {\n \"name\": \"INTERBANK\",\n \"city\": \"Lima\",\n \"accountType\": \"AHO\",\n \"accountNumber\": \"123456789012\"\n }\n}\n","options":{"raw":{"language":"json"}}},"url":"{{url}}/remittance/orders/v1/quotes/accept","description":"

B2B client accept a Quote to become an Order.

Request Body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
quoteId	string	true	Unique identifier of the Quote.
referenceOrderId	string	false	Reference ID that can be entered by the merchant.
customer	Person	true	Information of the person sending the payment. See the Person table below.
beneficiary	Person	true	Information of the person who will receive the payment. See the Person table below.
beneficiaryBankInfo	BankInfo	false	Information about the beneficiary's bank where the payment will be deposited. See the BankInfo table below. This information is only required when the transfer type is bank transfer. If the transfer is via wallet, only the phone number is required. Important: Is required when sending currency is FIAT.
beneficiaryCryptoInfo	CryptoInfo	false	Information about the beneficiary' crypto. Important: Is required when sending currency is CRYPTO.
fxMerchant	number	false	fxMerchant is an optional field that contains the merchant’s custom exchange rate for a specific provider. This value is stored for reference purposes.

Person body Table

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
firstName	string	true	Person's first name.
middleName	string	false	Intermediate names of the person.
lastName	string	true	Person's last name.
secondLastName	string	true	Second surname of the person.
city	string	true	City of residence of the person.
address	string	true	Residence address of the person.
phone	string	true	Contact number of the person.
email	string	true	Contact email of the person.
documentType	number	true	Type of identity document of the person. (DNI = 1, CE = 2, PASAPORTE = 3, RUC = 4, SOCIAL SEC. = 5, CPF = 41
ducumentNumber	string	true	Person's identity document number.

BankInfo body Table

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
name	string	true	Beneficiary bank name. Los bancos disponibles actualmente son: BANBIF BBVA BCP INTERBANK PICHINCHA SCOTIABANK MI BANCO BANCO DE LA NACION BANCO DE COMERCIO BANCO SANTANDER CITIBANK
city	string	true	Bank City.
accountType	string	true	Bank account type. Important: For payouts to Brazil, we will use PIX, so only the following types of keys are allowed as 'accountType': phone, email, cpf, cnpj, key.
accountNumber	string	true	By default, this field is a Bank account number. However, if the sending method is WALLET_PER-PEN, it should be a phone number linked to YAPE. If the sending method is WALLET_BRA-BRL, you may enter either an email or a phone number.
interbankAccountNumber	string	false	Interbank account number is optional. You can put the cci number on AccountNumber field.
cardReference	string	false	Card reference code is mandatory only when the sending method is B89_CARD_PER-USD or B89_CARD_PER-PEN. If the sending method is any of the above, all other fields except this one are optional.

BeneficiaryCryptoInfo body Table

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
protocol	string	true	Crypto protocol. Ejm: ERC20
address	string	true	Crypto address
tag	string	false	It is only necessary if the cryptocurrency to be sent is XRP.

Cash Pick Up Request Body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Property	Type	Required	Description
quoteId	string	true	Unique identifier of the Quote.
referenceOrderId	string	false	Reference ID that can be entered by the merchant.
customer.firstName	string	true	Customer's first name
customer.middleName	string	false	Customer's middle name (optional)
customer.lastName	string	true	Customer's primary last name
customer.secondLastName	string	false	Customer's second last name (maternal surname)
customer.city	string	false	Customer's city of residence
customer.address	string	false	Customer's full street address
customer.phone	string	true	Customer's contact phone number
customer.birthdate	string	true	Customer's date of birth (YYYY-MM-DD format)
customer.documentType	number	true	Type of identification document (e.g., 1, 2, 4)
customer.documentNumber	string	true	Customer's identification document number
beneficiary.firstName	string	true	Beneficiary's first name
beneficiary.middleName	string	false	Beneficiary's middle name (optional)
beneficiary.lastName	string	true	Beneficiary's primary last name
beneficiary.secondLastName	string	false	Beneficiary's second last name (maternal surname)
beneficiary.city	string	true	Beneficiary's city of residence
beneficiary.address	string	true	Beneficiary's full street address
beneficiary.phone	string	true	Beneficiary's contact phone number
beneficiary.birthdate	string	false	Beneficiary's date of birth (YYYY-MM-DD format)
beneficiary.documentType	number	true	Type of identification document (e.g., 1, 2, 4)
beneficiary.documentNumber	string	true	Beneficiary's identification document number
beneficiary.email	string	true	Beneficiary's email address for notifications
beneficiaryBankInfo	BankInfo	false	Bank account information for the beneficiary. This object is optional and only required when sendingMethod is not CASH_AGENT_PER-PEN or CASH_AGENT_VEN-VES. For cash pickup methods, this field can be omitted from the request.
beneficiaryCryptoInfo	CryptoInfo	false	Cryptocurrency wallet information for the beneficiary. This object is optional and only required when sendingMethod is not CASH_AGENT_PER-PEN or CASH_AGENT_VEN-VES. For cash pickup methods, this field can be omitted from the request.

","urlObject":{"path":["remittance","orders","v1","quotes","accept"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"94397805-d537-47e9-81b5-bac1cee9756b","name":"Accept Quote - 200","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"{{acceptQuoteSignature}}","description":"Signature Request","type":"text"},{"key":"X-Request-Timestamp","value":"{{acceptQuoteTimestamp}}","description":"Timestamp","type":"text"},{"key":"X-Request-publicKey","value":"{{publicKey}}","description":"B2B Public Key","type":"text"}],"body":{"mode":"raw","raw":"{\n \"quoteId\": \"3e9234a0-d273-11ee-9839-0242ac12000d\",\n \"referenceOrderId\": \"2b48d07d-3c7e-404a-a4c9-05f5a29b7cb9\",\n \"customer\": {\n \"firstName\": \"Enzo\",\n \"middleName\": \"Israel\",\n \"lastName\": \"Neyra\",\n \"secondLastName\": \"Dianderas\",\n \"city\": \"Cercado de Lima\",\n \"address\": \"Av. Mariano Cornejo 1848\",\n \"phone\": \"989218865\",\n \"documentType\": 1,\n \"documentNumber\": \"87654321\"\n },\n \"beneficiary\": {\n \"firstName\": \"Melissa\",\n \"lastName\": \"Neyra\",\n \"secondLastName\": \"Dianderas\",\n \"city\": \"SMP\",\n \"address\": \"calle jerusalen 108\",\n \"phone\": \"987654321\",\n \"documentType\": 1,\n \"documentNumber\": \"87654320\"\n },\n \"beneficiaryBankInfo\": {\n \"name\": \"INTERBANK\",\n \"city\": \"Lima\",\n \"accountType\": \"AHO\",\n \"accountNumber\": \"123456789012\"\n }\n}\n","options":{"raw":{"language":"json"}}},"url":"{{url}}/remittance/orders/v1/quotes/accept"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"50"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 23 Feb 2024 17:45:23 GMT"},{"key":"X-Request-Id","value":"b12f57c1-5769-4070-be12-54ae543d9474"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"5205cac2-d273-11ee-9839-0242ac12000d\"\n}"},{"id":"364f631f-aafd-4d77-8a7c-e360075e89a6","name":"404 Error","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"","description":"Signature Request","type":"text"},{"key":"X-Request-Timestamp","value":"","description":"Timestamp","type":"text"},{"key":"X-Request-publicKey","value":"","description":"B2B Public Key","type":"text"}],"body":{"mode":"raw","raw":"{\n \"receivingCurrency\": \"USD\",\n \"sendingAmount\": 500,\n \"sendingCountry\": \"PER\",\n \"sendingCurrency\": \"PEN\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/remittance/orders/v1/quote"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 16 Feb 2024 22:50:21 GMT"},{"key":"X-Request-Id","value":"69ac09e8-a303-487d-9fd4-05a5d771a933"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"MoleculerError\",\n \"message\": \"There is no merchant associated with the public key.\",\n \"code\": 404,\n \"type\": \"ValidationMerchantPublicKeyNotExistError\"\n}"}],"_postman_id":"ad4ad0f9-df43-4ea3-901d-cca394c85f37"},{"name":"Get Sending Methods","event":[{"listen":"prerequest","script":{"id":"e53bcae2-7989-48b2-ace9-5e675df1828f","exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"92d4e3b5-1862-40ff-a78f-df384de4e9bb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{url}}/remittance/orders/v1/quotes/sending-methods?currency=PEN&country=PER","description":"

Response 200

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
sendingMethodReference	string	Sending method reference. This value is what you need for the Create Quote service.
sendingMethodDescription	string	Sending method description.

Responses Error

\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Response
500	{\"message\":\"An unexpected error occurred.\"}

","urlObject":{"path":["remittance","orders","v1","quotes","sending-methods"],"host":["{{url}}"],"query":[{"key":"currency","value":"PEN"},{"key":"country","value":"PER"}],"variable":[]}},"response":[{"id":"6159d16b-1859-4336-a085-4757eb310f3d","name":"Get Sending Methods - 200","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/remittance/orders/v1/quotes/sending-methods?currency=PEN&country=PER","host":["{{url}}"],"path":["remittance","orders","v1","quotes","sending-methods"],"query":[{"key":"currency","value":"PEN"},{"key":"country","value":"PER"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"sendingMethodReference\": \"BANK_TRANSFER_PER-PEN\",\n \"sendingMethodDescription\": \"Depósito a través de transferencia bancaria hacia una cuenta en Perú en PEN\"\n }\n ]\n}"}],"_postman_id":"92d4e3b5-1862-40ff-a78f-df384de4e9bb"},{"name":"Get Exchange Rate","event":[{"listen":"prerequest","script":{"id":"0ede5673-9242-4783-b73b-daa3f66649dd","exec":["var requestDetails = {","pm.collectionVariables.get(\"variable_key\");"," url: `${pm.environment.get('url')}/merchants/v1/sign`,"," method: 'POST',"," header: 'Content-Type:application/json',"," body: {"," mode: 'raw',"," raw: JSON.stringify({"," secretKey: \"cd7b1336-885b-4581-8038-02e822e20777\","," privateKey: \"-----BEGIN ENCRYPTED PRIVATE KEY-----\\r\\n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\\r\\nUmGVHtM/iAKWijcsjWIc+DiUZw==\\r\\n-----END ENCRYPTED PRIVATE KEY-----\\r\\n\","," queryString: {},"," body: {}"," })"," }","};","","pm.sendRequest(requestDetails, function (err, response) {"," if (err) {"," console.log(err);"," } else {"," var responseData = response.json();"," console.log(responseData);"," var timestamp = responseData.timestamp;"," var signature = responseData.signature;",""," pm.environment.set(\"getQuoteTimestamp\", timestamp);"," pm.environment.set(\"getQuoteSignature\", signature);"," }","});",""],"type":"text/javascript","packages":{}}}],"id":"2f3bcde8-f552-4af4-9a07-91e98242e7d7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{getQuoteSignature}}","description":"

Signature Request

\n"},{"key":"X-Request-Timestamp","value":"{{getQuoteTimestamp}}","description":"

Timestamp

\n"},{"key":"X-Request-publicKey","value":"{{publicKey}}","description":"

B2B Public Key

\n"}],"url":"{{url}}/utils/v1/exchange/fx-rate?country=PER","description":"

Description

This response indicates a successful request and provides information about the currency exchange rate.

Query Param

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
country	string	true	Target currency country for the beneficiary. Target currency country for the beneficiary. The currency source is always USD.

Reponse 200

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description	Example
id	string	Unique identifier for the currency exchange transaction.	08eb3790-ace1-43d0-bd96-28b0c8e2fd08
currencySource	string	The source currency code (ISO 4217 code).	USD
targetCurrency	string	The target currency code (ISO 4217 code).	PEN
activationDatetime	string	The date and time when the exchange rate is activated.	2024-05-11
rate	number	The exchange rate from the source currency to the target currency.	3.6925

Responses Error

\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Response
500	{\"message\":\"An unexpected error occurred.\"}

","urlObject":{"path":["utils","v1","exchange","fx-rate"],"host":["{{url}}"],"query":[{"key":"country","value":"PER"}],"variable":[]}},"response":[{"id":"7e3e3fd6-ff72-4336-918e-f9e4d6407be6","name":"Get Exchange Rate - 200","originalRequest":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{getQuoteSignature}}","description":"Signature Request"},{"key":"X-Request-Timestamp","value":"{{getQuoteTimestamp}}","description":"Timestamp"},{"key":"X-Request-publicKey","value":"{{publicKey}}","description":"B2B Public Key"}],"url":"{{url}}/utils/v1/exchange/fx-rate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"150"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Sat, 11 May 2024 12:41:50 GMT"},{"key":"X-Request-Id","value":"375d71f8-79d9-4319-97dd-b20abb0132ce"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": \"08eb3790-ace1-43d0-bd96-28b0c8e2fd08\",\n \"currencySource\": \"USD\",\n \"targetCurrency\": \"PEN\",\n \"activationDatetime\": \"2024-05-11\",\n \"rate\": 3.6925\n }\n ]\n}"},{"id":"59ce4cfa-f2f4-44db-a6c0-bc9db39f1997","name":"Get Exchange Rate - 200 (empty)","originalRequest":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{getQuoteSignature}}","description":"Signature Request"},{"key":"X-Request-Timestamp","value":"{{getQuoteTimestamp}}","description":"Timestamp"},{"key":"X-Request-publicKey","value":"{{publicKey}}","description":"B2B Public Key"}],"url":"{{url}}/utils/v1/exchange/fx-rate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"11"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Sat, 11 May 2024 12:40:54 GMT"},{"key":"X-Request-Id","value":"7786e290-4654-48d7-ab51-39b12d79b3f1"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": []\n}"}],"_postman_id":"2f3bcde8-f552-4af4-9a07-91e98242e7d7"},{"name":"Get Quote","event":[{"listen":"prerequest","script":{"id":"9726298b-ab87-4f42-b063-b854697bdfd8","exec":["var requestDetails = {\r"," url: `${pm.environment.get('url')}/merchants/v1/sign`,\r"," method: 'POST',\r"," header: 'Content-Type:application/json',\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," secretKey: \"cd7b1336-885b-4581-8038-02e822e20777\",\r"," privateKey: \"-----BEGIN ENCRYPTED PRIVATE KEY-----\\r\\nMIIJnzBJBgkqhkiG9w0BBQ0wPDAbBgkqhkiG9w0BBQwwDgQIR8T6AGBuS/oCAggA\\r\\nMB0GCWCGSAFlAwQBKgQQumHrSHz5mA6XUG2U6bKnZQSCCVBRDB/SQqhYGXnfXG9+\\r\\nFwucVDQvQ0PRMnJr8mVZCNiaQlPbPhLx+hGzhFs2/sELM65fPz5N+DqKQpmnfv5W\\r\\nsceTL/88k4Du6McISbTGewIW04ylrTgCnjwaLijAsAnLvN3OLid0v+IxS+DUYsMs\\r\\n5ywSJssYMSGKZAyYWvl0SPm9+s0UNRtXphHvlmeb6dWhazYz88Dem5YncImqH6xz\\r\\nKhBkf/qs7jNZbLCwJm72JTpw/gJGqP07t1VCs7rCs78iRF9YUUOWU09GNNGA1yU3\\r\\n64/gTEvffMfZkajILA9Yg9/3sCjdOmuF8hG0/onVmg9TSLnsrki45KvvcCLjuuv5\\r\\n9goXbBy83/aDsYLAz0wwIvB4zoB18oCoYhwjHwy5WeQS6vJtglWWHcRTJkSmONAS\\r\\nA1PBwKSz/QzL45cajhAAfO0rszIEt6/IOEUsJjNsHyoKBi6pXJcdBk2eAqLnwK+9\\r\\nk7hSh7pvr1WoLetm1SdCKfO5HKV8FqQfCwHPfIsPqEWrCK/7ASaA9YuJUGzJ/M8+\\r\\nERCKKd0OOdT/yPSmXDVI7kC28mOTKHb7WXyYAniS1uen1SJ2IkGiaypng4AXzaXI\\r\\nuLCBRRwtG8Xamwl2lmxqXOOHZaz247XoWLfUbAaDOIE0qFro3TV3l0ET9TooJYxd\\r\\nx2wGasdlWJ4zeOykFUFCs0fuCCHJknd7hwk8WCnE6Hk2jijY9/GpyhgxMPbbS9dZ\\r\\nvMLWkSWOlVLtvrcXNkNuAcO9iIUSfxGuWwsgj+BpsU7GZBpAj5ZB3MIb1sJ223wc\\r\\nn9ypd2kE+Cq3Xlfzb6TN5ZngUJheIWZYoPd3VdgP8BMjjBFhpZF4VW0gyEwqApXy\\r\\nnfgJRzhcStia6WK0D0qJts/2n4DGBTTlBdlCt+GPDYe1ZNqGW5aZ0aQMFd2Ruavy\\r\\nsB1bfQTh7S5nLd2TJrvow7DsAqLrYmIXc6DhclDyFDKWFXYQiukf56lfLVSKv5zU\\r\\nlzAdFHesj6bMAviMLWp38KDo+ip4Ws7mMfF2KC+bdjrNrtlIWTH/m68NDB6aGCqB\\r\\noCpmojvVYHjp6OmBIUnDmLTtI4yEr9amOOkIBkzQ4AY65azQ/Jsq0EvUNJKg/jYR\\r\\nRy3xMj1h/9tKNHDj6Q+oJhYl6ADuaesn5k7wY2tzcXPqTCHrX1dd1jq8woyhrXLf\\r\\n4em3fpZZOV8dWID/EVlGJBK37cAgfrYMaTZVJFlAUW58WHUIdSRxuQMe+5n5dQEt\\r\\n/jB3zANPB2IBINYLwD0q0WQrk6XSUQn0XT+Ble2QivLHa2s6pM67tRAJXIBGj+Df\\r\\ni8TsS02/R7lxaIUCxDze3yYeVt8cp297QujVGQW8o8w9z+amN68VfR6yo3pW89Zu\\r\\n8VxqiZ5q9FpPVwbbJe1KzApK3CC+yPmP5atSrmj/ELnNAlfo3AAhU6+rH0kfcQkC\\r\\n2KkvAXzqIgBX67QSlrYYM4KiT7ZkGu1yxehtTlKSbOOuitczXkFZgc1oFI8zXxm7\\r\\nngJ3OZdH4tOM2I4+JYvoZ5JWhrANylKGZ150TDh72sRjVJuLnH+Yir6nMHtlCaSC\\r\\nx/FrXI64G0T/SmO2lVjTUyXdYn+gKBKTZeO66HCBYzylGpLwtuyV5eOVbEsTBWgQ\\r\\nknc7lFcrvSMSdVEzZr5K6aAniJhQzKR77vXqACcedzuVFDgu1bnk8Mwj1wFrzrCV\\r\\nPI/gkTY18PfNTkoduwxuZNmQCjb1f4fUvGSZX81ZNfB2L0ox5GhGN1t8dn0w3bXK\\r\\nXQ8ykroL37H0qo0guk9MOZf1yErDT5njVy6UACE4OcaBq8zyfuRnx0yj0HiKbFS1\\r\\n77/y0IyaH6rt7FKx7uzsADDHodlyFb69EUic7aeE527HoVPoLczNH+S3NTKXY4RP\\r\\nSaXTLy7mJ4dYL095sq4gw0mt2W04C+fkUNFvF10rcrXAFFLfRWWvU02rgem8mjD9\\r\\nLDvOUNt8vePf5FAdZILRlYBuqIDOxPNCzB24rvzCnvKd5QpHuWhBNQ8btNdchyqW\\r\\nIg1Vdb7znwfawtoNJFQ6hsrSunlrag6xCXQvcmRNFqNNu5ySa4BFCS8VO3bRAYH4\\r\\nwZEOvAgyhgc7AHMQ3P4usxqkJTdXfEKBPumk6PJ898PUEbxhRB67NDr5JlL5ORgm\\r\\nwegbJ3PaJM8XqNfXipYO4/MbMBobwiX2+ohptBJl/aDqsaZkhby8vlQ+ZLq2jUdY\\r\\nTSKC3dPUxwEkPjB0gH6ObNJKtgGtCOBxr+OscY3fnYGhaZZ4k2Lmr+zGMX5qINVT\\r\\nONI2v+zP3d6HIAMKjM/TH+a4fpnR9UH20ntxo7Lnx8WQF0n2B3Ej2cZWK6EOZ5ic\\r\\nQl23iRqfhjzoC9Z0W8SUboWTkw3O6NPRsb7z1XMcrAnHHvgubnJOh/mmO8lPRbDM\\r\\nnlSHiLtVgh+yjZlNiZVnFJf87hy2uv+P8zDIhx2WvZ53M47Qh9aojnphY/YiAy1J\\r\\na7PDQK7IQgN59/EVZKf1xmNkhbD9chjHQ//408p0t+U7uOk2viqR0lFBm0Mlwv8A\\r\\n29+XpYU7W1eyWfU3WPI3QWkCBCvPeQXCgSn4u9RdMM8eKmPiSY8mVYdcQd6KP4Ya\\r\\n1B/X3D4PZVgM6AbdRsaq4OJPirnGHciLVY99k32yV1zH4lGMLk9NnYrkWENRYjms\\r\\nQ78kazFzdfp3eVhj/bclda3oN4L4cgdsyxBr+tnQlis7GklShRilgPNRoify/fMm\\r\\n5EfrLrQ/uKsl0L24fDoKXf+GxLEZdSIZt1Zv0m/kgFsWv9oq22OVs4RiagTXfzd/\\r\\nn3/oR+siyo2NGE/Cn7uVa2ZDVCQKjKD51M+qCCQ9KiXorzyXHd3ae3pFTg9WjKue\\r\\nckcNV7D+RrwsfhDiMsGYRx03DIKrZ2GFvf+ZJr03XzVCmZUf1uKdo5g06UASeWPG\\r\\nPKEQxZO0CUX8mlUVLaP8PpaADiNafA5lCT+Zyi7UHssroYuZYzMa/ANPJX8xS7t7\\r\\noKQD/s03uwAVuLj7N/eK8zzyEtnNlsStsjNrNQ66xeoMdhm6VEhsZcTdPkjsKBpc\\r\\nV7/Q/DIeBUdtZNKoiRyuG6l0VddXGpNW6ZhfouFRMla5P+TbxcKh62B1Ko77qRwT\\r\\n+g3LGzLg17uRhUi4ScnBzmGzFGvo+nvVDBth+iwEEOqRXy3oaq1Ws3W8tBQby6rm\\r\\nUmGVHtM/iAKWijcsjWIc+DiUZw==\\r\\n-----END ENCRYPTED PRIVATE KEY-----\\r\\n\",\r"," queryString: {\r"," id: \"8ae4697d-dcdc-11ee-9e60-0242ac120008\"\r"," },\r"," body: {}\r"," })\r"," }\r","};\r","\r","pm.sendRequest(requestDetails, function (err, response) {\r"," if (err) {\r"," console.log(err);\r"," } else {\r"," var responseData = response.json();\r"," console.log(responseData);\r"," var timestamp = responseData.timestamp;\r"," var signature = responseData.signature;\r","\r"," pm.environment.set(\"getQuoteTimestamp\", timestamp);\r"," pm.environment.set(\"getQuoteSignature\", signature);\r"," }\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"213e50ef-f488-4e6a-afb9-826f70cc3208","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{getQuoteSignature}}","description":"

Signature Request

\n","type":"text"},{"key":"X-Request-Timestamp","value":"{{getQuoteTimestamp}}","description":"

Timestamp

\n","type":"text"},{"key":"X-Request-publicKey","value":"{{publicKey}}","description":"

B2B Public Key

\n","type":"text"}],"url":"{{url}}/remittance/orders/v1/quotes/8ae4697d-dcdc-11ee-9e60-0242ac120008","description":"

Gets the quote created by the B2B client.

Response 200

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
id	string	Unique identifier of the Quote.
sendingCurrency	string	Type of currency in ISO 4217 that you want the beneficiary of the payout to receive. Example: PEN.
sendingAmount	number	Amount of money that you want the beneficiary to receive.
receivingAmount	number	Amount of money that the B2B client will pay to B89 to send the payout.
receivingCountry	string	Country where the payout comes from.
receivingCurrency	string	Type of currency in ISO 4217 that B89 will receive from the B2B client. Example: USD.
merchantId	string	Unique identifier of the B2B client.
exchangeRate	number	The exchange rate that will be used to send the payout.
createdDatetime	string	Quote creation date and time.
expirationDatetime	string	Date and time limit in which the Quote is valid.
status	string	status in which the Quote is (PENDING, EXPIRED, CONFIRMED).

Responses Error

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Response
404	{\"type\":\"GetQuoteIdNotExistError\"}
401	{\"type\": \"ValidationMerchantInvalidTimestampError\"}
401	{\"type\": \"ValidationMerchantCredentialsDoesntMatchError\"}
401	{\"type\":\"ValidationMerchantUnauthorizedError\"}
500	{\"message\":\"An unexpected error occurred.\"}

","urlObject":{"path":["remittance","orders","v1","quotes","8ae4697d-dcdc-11ee-9e60-0242ac120008"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"c7271fd0-9eea-445a-b358-817d83987172","name":"Get Quote - 200","originalRequest":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{getQuoteSignature}}","description":"Signature Request","type":"text"},{"key":"X-Request-Timestamp","value":"{{getQuoteTimestamp}}","description":"Timestamp","type":"text"},{"key":"X-Request-publicKey","value":"{{publicKey}}","description":"B2B Public Key","type":"text"}],"url":"{{url}}/remittance/orders/v1/quotes/8ae4697d-dcdc-11ee-9e60-0242ac120008"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"id\": \"8ae4697d-dcdc-11ee-9e60-0242ac120008\",\n \"receivingCurrency\": \"USD\",\n \"sendingCurrency\": \"PEN\",\n \"sendingAmount\": 100,\n \"receivingAmount\": 27.0599,\n \"receivingCountry\": \"URY\",\n \"merchantId\": \"0d97de64-3bbb-4fe2-8e78-6ba22a005514\",\n \"exchangeRate\": 3.6955,\n \"createdDatetime\": \"2024-03-07 13:43:47\",\n \"expirationDatetime\": \"2024-03-07 14:43:47\",\n \"status\": \"PENDING\"\n }\n}"},{"id":"ee57cba1-9fb4-431e-9aad-1bae2b9c0ce2","name":"404 Error","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"","description":"Signature Request","type":"text"},{"key":"X-Request-Timestamp","value":"","description":"Timestamp","type":"text"},{"key":"X-Request-publicKey","value":"","description":"B2B Public Key","type":"text"}],"body":{"mode":"raw","raw":"{\n \"receivingCurrency\": \"USD\",\n \"sendingAmount\": 500,\n \"sendingCountry\": \"PER\",\n \"sendingCurrency\": \"PEN\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/orders/v1/quote"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 16 Feb 2024 22:50:21 GMT"},{"key":"X-Request-Id","value":"69ac09e8-a303-487d-9fd4-05a5d771a933"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"MoleculerError\",\n \"message\": \"There is no merchant associated with the public key.\",\n \"code\": 404,\n \"type\": \"ValidationMerchantPublicKeyNotExistError\"\n}"}],"_postman_id":"213e50ef-f488-4e6a-afb9-826f70cc3208"},{"name":"Get Quotes","event":[{"listen":"prerequest","script":{"id":"f6514536-5a4a-4905-8c9a-896482ccfe3f","exec":["var requestDetails = {\r"," url: \"https://uat-apipayments.b89.io/merchants/v1/sign\",\r"," method: 'POST',\r"," header: 'Content-Type:application/json',\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," secretKey: \"cd7b1336-885b-4581-8038-02e822e20777\",\r"," privateKey: \"-----BEGIN ENCRYPTED PRIVATE KEY-----\\r\\n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\\r\\nUmGVHtM/iAKWijcsjWIc+DiUZw==\\r\\n-----END ENCRYPTED PRIVATE KEY-----\\r\\n\",\r"," queryString: {},\r"," body: {}\r"," })\r"," }\r","};\r","\r","pm.sendRequest(requestDetails, function (err, response) {\r"," if (err) {\r"," console.log(err);\r"," } else {\r"," var responseData = response.json();\r"," console.log(responseData);\r"," var timestamp = responseData.timestamp;\r"," var signature = responseData.signature;\r","\r"," pm.environment.set(\"getQuotesTimestamp\", timestamp);\r"," pm.environment.set(\"getQuotesSignature\", signature);\r"," }\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"ee628b98-8329-4a02-afcf-ed4af9227703","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{getQuotesSignature}}","description":"

Signature Request

\n","type":"text"},{"key":"X-Request-Timestamp","value":"{{getQuotesTimestamp}}","description":"

Timestamp

\n","type":"text"},{"key":"X-Request-publicKey","value":"{{publicKey}}","description":"

B2B Public Key

\n","type":"text"}],"url":"{{url}}/remittance/orders/v1/quotes","description":"

Gets the quotes created by the B2B client.

Response Ok

Quote Array:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
id	string	Unique identifier of the Quote.
sendingCurrency	string	Type of currency in ISO 4217 that you want the beneficiary of the payout to receive. Example: PEN.
sendingAmount	number	Amount of money that you want the beneficiary to receive.
receivingAmount	number	Amount of money that the B2B client will pay to B89 to send the payout.
receivingCountry	string	Country where the payout comes from.
receivingCurrency	string	Type of currency in ISO 4217 that B89 will receive from the B2B client. Example: USD.
merchantId	string	Unique identifier of the B2B client.
exchangeRate	number	The exchange rate that will be used to send the payout.
createdDatetime	string	Quote creation date and time.
expirationDatetime	string	Date and time limit in which the Quote is valid.
status	string	status in which the Quote is (PENDING, EXPIRED, CONFIRMED).

Responses Error

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Response
401	{\"type\": \"ValidationMerchantInvalidTimestampError\"}
401	{\"type\": \"ValidationMerchantCredentialsDoesntMatchError\"}
401	{\"type\":\"ValidationMerchantUnauthorizedError\"}
500	{\"message\":\"An unexpected error occurred.\"}

","urlObject":{"path":["remittance","orders","v1","quotes"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"6f498f1b-a2ff-476a-bd54-06a97334f36f","name":"Get Quotes - 200","originalRequest":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{getQuotesSignature}}","description":"Signature Request","type":"text"},{"key":"X-Request-Timestamp","value":"{{getQuotesTimestamp}}","description":"Timestamp","type":"text"},{"key":"X-Request-publicKey","value":"{{publicKey}}","description":"B2B Public Key","type":"text"}],"url":"{{url}}/remittance/orders/v1/quotes"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": \"01ecd7f5-d292-11ee-9839-0242ac12000d\",\n \"receivingCurrency\": \"USD\",\n \"sendingCurrency\": \"PEN\",\n \"sendingAmount\": 100,\n \"receivingAmount\": 26.4166,\n \"receivingCountry\": \"URY\",\n \"merchantId\": \"0d97de64-3bbb-4fe2-8e78-6ba22a005514\",\n \"exchangeRate\": 3.7855,\n \"createdDatetime\": \"2024-02-23 11:25:03\",\n \"expirationDatetime\": \"2024-02-23 12:25:03\",\n \"status\": \"PENDING\"\n },\n {\n \"id\": \"3e9234a0-d273-11ee-9839-0242ac12000d\",\n \"receivingCurrency\": \"USD\",\n \"sendingCurrency\": \"PEN\",\n \"sendingAmount\": 500,\n \"receivingAmount\": 132.0829,\n \"receivingCountry\": \"URY\",\n \"merchantId\": \"0d97de64-3bbb-4fe2-8e78-6ba22a005514\",\n \"exchangeRate\": 3.7855,\n \"createdDatetime\": \"2024-02-23 07:44:50\",\n \"expirationDatetime\": \"2024-02-23 08:44:50\",\n \"status\": \"PENDING\"\n },\n {\n \"id\": \"8ae4697d-dcdc-11ee-9e60-0242ac120008\",\n \"receivingCurrency\": \"USD\",\n \"sendingCurrency\": \"PEN\",\n \"sendingAmount\": 100,\n \"receivingAmount\": 27.0599,\n \"receivingCountry\": \"URY\",\n \"merchantId\": \"0d97de64-3bbb-4fe2-8e78-6ba22a005514\",\n \"exchangeRate\": 3.6955,\n \"createdDatetime\": \"2024-03-07 13:43:47\",\n \"expirationDatetime\": \"2024-03-07 14:43:47\",\n \"status\": \"CONFIRMED\"\n },\n {\n \"id\": \"c7594f0b-d07a-11ee-9839-0242ac12000d\",\n \"receivingCurrency\": \"USD\",\n \"sendingCurrency\": \"PEN\",\n \"sendingAmount\": 500,\n \"receivingAmount\": 132.7492,\n \"receivingCountry\": \"URY\",\n \"merchantId\": \"0d97de64-3bbb-4fe2-8e78-6ba22a005514\",\n \"exchangeRate\": 3.7665,\n \"createdDatetime\": \"2024-02-20 19:33:44\",\n \"expirationDatetime\": \"2024-02-20 20:33:44\",\n \"status\": \"PENDING\"\n }\n ]\n}"},{"id":"4a470c55-d640-401c-aa94-229679ab91ed","name":"404 Error","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"","description":"Signature Request","type":"text"},{"key":"X-Request-Timestamp","value":"","description":"Timestamp","type":"text"},{"key":"X-Request-publicKey","value":"","description":"B2B Public Key","type":"text"}],"body":{"mode":"raw","raw":"{\n \"receivingCurrency\": \"USD\",\n \"sendingAmount\": 500,\n \"sendingCountry\": \"PER\",\n \"sendingCurrency\": \"PEN\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/remittance/orders/v1/quote"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 16 Feb 2024 22:50:21 GMT"},{"key":"X-Request-Id","value":"69ac09e8-a303-487d-9fd4-05a5d771a933"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"MoleculerError\",\n \"message\": \"There is no merchant associated with the public key.\",\n \"code\": 404,\n \"type\": \"ValidationMerchantPublicKeyNotExistError\"\n}"}],"_postman_id":"ee628b98-8329-4a02-afcf-ed4af9227703"},{"name":"Get Order","event":[{"listen":"prerequest","script":{"id":"f61aa221-9df2-4d38-8868-665d84d10fc9","exec":["var requestDetails = {\r"," url: \"https://uat-apipayments.b89.io/merchants/v1/sign\",\r"," method: 'POST',\r"," header: 'Content-Type:application/json',\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," secretKey: \"cd7b1336-885b-4581-8038-02e822e20777\",\r"," privateKey: \"-----BEGIN ENCRYPTED PRIVATE KEY-----\\r\\n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\\r\\nUmGVHtM/iAKWijcsjWIc+DiUZw==\\r\\n-----END ENCRYPTED PRIVATE KEY-----\\r\\n\",\r"," queryString: {\r"," id: \"4c36f4b4-dcdd-11ee-9e60-0242ac120008\"\r"," },\r"," body: {}\r"," })\r"," }\r","};\r","\r","pm.sendRequest(requestDetails, function (err, response) {\r"," if (err) {\r"," console.log(err);\r"," } else {\r"," var responseData = response.json();\r"," console.log(responseData);\r"," var timestamp = responseData.timestamp;\r"," var signature = responseData.signature;\r","\r"," pm.environment.set(\"getOrderTimestamp\", timestamp);\r"," pm.environment.set(\"getOrderSignature\", signature);\r"," }\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"3e704797-c070-4df0-af6f-1edffd32080a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{getOrderSignature}}","description":"

Signature Request

\n","type":"text"},{"key":"X-Request-Timestamp","value":"{{getOrderTimestamp}}","description":"

Timestamp

\n","type":"text"},{"key":"X-Request-publicKey","value":"{{publicKey}}","description":"

B2B Public Key

\n","type":"text"}],"url":"{{url}}/remittance/orders/v1/4c36f4b4-dcdd-11ee-9e60-0242ac120008","description":"

Gets the order created by the B2B client.

Response 200

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
id	string	Unique identifier of the Order.
quoteId	string	Unique identifier of the Quote.
receivingCurrency	string	Type of currency in ISO 4217 that B89 will receive from the B2B client. Example: USD.
receivingAmount	number	Amount of money that the B2B client will pay to B89 to send the payout.
sendingCurrency	string	Type of currency in ISO 4217 that you want the beneficiary of the payout to receive. Example: PEN.
sendingAmount	number	Amount of money that you want the beneficiary to receive.
sendingCountry	string	Country where the beneficiary of the payout is located.
receivingCountry	string	Country where the payout comes from.
exchangeRate	number	The exchange rate that will be used to send the payout.
statusOrder	string	status in which the ORDER is (CREATED, RECEIVED, COMPLIANCE_COMPLETED, RELEASE_PAYMENT_COMPLETED, B2B_PAYMENT_CONFIRMATION_COMPLETED)
comment	string	Provides the error description when the payment status contains failed or has failed at any other point in the process.
customer	Person	Information of the person sending the payment. See the Person table below.
beneficiary	Person	Information of the person who will receive the payment. See the Person table below.
beneficiaryBankInfo	BankInfo	Information about the beneficiary's bank where the payment will be deposited. See the BankInfo table below.
createdDatetime	string	Order creation date and time.
expirationDatetime	string	Date and time limit in which the Order is valid.

Person body Table

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
firstName	string	true	Person's first name.
middleName	string	false	Intermediate names of the person.
lastName	string	true	Person's last name.
secondLastName	string	true	Second surname of the person.
city	string	true	City of residence of the person.
address	string	true	Residence address of the person.
phone	string	true	Contact number of the person.
email	string	true	Contact email of the person.
documentType	number	true	Type of identity document of the person. (DNI = 1, CE = 2, PASAPORTE = 3, RUC = 4, SOCIAL SEC. = 5.
ducumentNumber	string	true	Person's identity document number.

BankInfo body Table

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
name	string	true	Beneficiary bank name.
city	string	true	Bank City.
accountType	string	true	Bank account type.
accountNumber	string	true	Bank account number
interbankAccountNumber	string	false	Interbank account number

Responses Error

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Response
404	{\"type\":\"GetOrderNotExistError\"}
401	{\"type\": \"ValidationMerchantInvalidTimestampError\"}
401	{\"type\": \"ValidationMerchantCredentialsDoesntMatchError\"}
401	{\"type\":\"ValidationMerchantUnauthorizedError\"}
500	{\"message\":\"An unexpected error occurred.\"}

","urlObject":{"path":["remittance","orders","v1","4c36f4b4-dcdd-11ee-9e60-0242ac120008"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"86e819cf-c2b7-4d71-9e27-fdf10a7bdc22","name":"Get Order - 200","originalRequest":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{getOrderSignature}}","description":"Signature Request","type":"text"},{"key":"X-Request-Timestamp","value":"{{getOrderTimestamp}}","description":"Timestamp","type":"text"},{"key":"X-Request-publicKey","value":"{{publicKey}}","description":"B2B Public Key","type":"text"}],"url":"{{url}}/remittance/orders/v1/4c36f4b4-dcdd-11ee-9e60-0242ac120008"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"id\": \"4c36f4b4-dcdd-11ee-9e60-0242ac120008\",\n \"quoteId\": \"8ae4697d-dcdc-11ee-9e60-0242ac120008\",\n \"receivingCurrency\": \"USD\",\n \"receivingAmount\": 27.0599,\n \"receivingCountry\": \"URY\",\n \"sendingCurrency\": \"PEN\",\n \"sendingAmount\": 100,\n \"sendingCountry\": \"PER\",\n \"feeAmount\": 0,\n \"exchangeRate\": 3.6955,\n \"statusOrder\": \"RECEIVED\",\n \"comment\": \"\",\n \"customer\": {\n \"firstName\": \"Enzo\",\n \"middleName\": \"\",\n \"lastName\": \"Neyra\",\n \"secondLastName\": \"Neyra\",\n \"city\": \"Cercado de Lima\",\n \"address\": \"Av. Mariano Cornejo 1848\",\n \"phone\": \"989218865\",\n \"documentType\": 1,\n \"documentNumber\": \"87654321\"\n },\n \"beneficiary\": {\n \"firstName\": \"Melissa\",\n \"middleName\": \"\",\n \"lastName\": \"Neyra\",\n \"secondLastName\": \"Dianderas\",\n \"city\": \"SMP\",\n \"address\": \"calle jerusalen 108\",\n \"phone\": \"987654321\",\n \"documentType\": 1,\n \"documentNumber\": \"87654320\"\n },\n \"beneficiaryBankInfo\": {\n \"name\": \"INTERBANK\",\n \"city\": \"Lima\",\n \"accountType\": \"AHO\",\n \"accountNumber\": \"123456789012\"\n },\n \"createdDatetime\": \"2024-03-07\",\n \"expirationDatetime\": \"2024-03-07\"\n }\n}"},{"id":"9a566b82-ebda-4227-9552-8fb37a2f37eb","name":"404 Error","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"","description":"Signature Request","type":"text"},{"key":"X-Request-Timestamp","value":"","description":"Timestamp","type":"text"},{"key":"X-Request-publicKey","value":"","description":"B2B Public Key","type":"text"}],"body":{"mode":"raw","raw":"{\n \"receivingCurrency\": \"USD\",\n \"sendingAmount\": 500,\n \"sendingCountry\": \"PER\",\n \"sendingCurrency\": \"PEN\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/orders/v1/quote"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 16 Feb 2024 22:50:21 GMT"},{"key":"X-Request-Id","value":"69ac09e8-a303-487d-9fd4-05a5d771a933"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"MoleculerError\",\n \"message\": \"There is no merchant associated with the public key.\",\n \"code\": 404,\n \"type\": \"ValidationMerchantPublicKeyNotExistError\"\n}"}],"_postman_id":"3e704797-c070-4df0-af6f-1edffd32080a"},{"name":"Get Orders","event":[{"listen":"prerequest","script":{"id":"3def5179-051e-4463-9bb0-abed47c6379f","exec":["var requestDetails = {\r"," url: \"https://uat-apipayments.b89.io/merchants/v1/sign\",\r"," method: 'POST',\r"," header: 'Content-Type:application/json',\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," secretKey: \"cd7b1336-885b-4581-8038-02e822e20777\",\r"," privateKey: \"-----BEGIN ENCRYPTED PRIVATE KEY-----\\r\\n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\\r\\nUmGVHtM/iAKWijcsjWIc+DiUZw==\\r\\n-----END ENCRYPTED PRIVATE KEY-----\\r\\n\",\r"," queryString: {},\r"," body: {}\r"," })\r"," }\r","};\r","\r","pm.sendRequest(requestDetails, function (err, response) {\r"," if (err) {\r"," console.log(err);\r"," } else {\r"," var responseData = response.json();\r"," console.log(responseData);\r"," var timestamp = responseData.timestamp;\r"," var signature = responseData.signature;\r","\r"," pm.environment.set(\"getOrdersTimestamp\", timestamp);\r"," pm.environment.set(\"getOrdersSignature\", signature);\r"," }\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"a1a057fa-5c0c-405f-9149-f154424fb446","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{getOrdersSignature}}","description":"

Signature Request

\n","type":"text"},{"key":"X-Request-Timestamp","value":"{{getOrdersTimestamp}}","description":"

Timestamp

\n","type":"text"},{"key":"X-Request-publicKey","value":"{{publicKey}}","description":"

B2B Public Key

\n","type":"text"}],"url":"{{url}}/remittance/orders/v1","description":"

Gets the orders created by the B2B client.

Optional Filters Query Param

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
referenceOrderId	string	false	Reference order id entered by the merchant.

Response Ok

Order Array:

Response 200

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
id	string	Unique identifier of the Order.
referenceOrderId	string	Reference ID entered by the merchant for internal control.
quoteId	string	Unique identifier of the Quote.
receivingCurrency	string	Type of currency in ISO 4217 that B89 will receive from the B2B client. Example: USD.
receivingAmount	number	Amount of money that the B2B client will pay to B89 to send the payout.
sendingCurrency	string	Type of currency in ISO 4217 that you want the beneficiary of the payout to receive. Example: PEN.
sendingAmount	number	Amount of money that you want the beneficiary to receive.
sendingCountry	string	Country where the beneficiary of the payout is located.
receivingCountry	string	Country where the payout comes from.
exchangeRate	number	The exchange rate that will be used to send the payout.
statusOrder	string	status in which the ORDER is (CREATED, RECEIVED, COMPLIANCE_COMPLETED, RELEASE_PAYMENT_COMPLETED, B2B_PAYMENT_CONFIRMATION_COMPLETED)
comment	string	Provides the error description when the payment status contains failed or has failed at any other point in the process.
beneficiaryBankInfo	BankInfo	Information about the beneficiary's bank where the payment will be deposited. See the BankInfo table below. If you need detailed information about the beneficiary and customer, please refer to the GetOrder service for a comprehensive view.
createdDatetime	string	Order creation date and time.
expirationDatetime	string	Date and time limit in which the Order is valid.

BankInfo body Table

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
name	string	true	Beneficiary bank name.
city	string	true	Bank City.
accountType	string	true	Bank account type.
accountNumber	string	true	Bank account number
interbankAccountNumber	string	false	Interbank account number

Responses Error

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Response
401	{\"type\": \"ValidationMerchantInvalidTimestampError\"}
401	{\"type\": \"ValidationMerchantCredentialsDoesntMatchError\"}
401	{\"type\":\"ValidationMerchantUnauthorizedError\"}
500	{\"message\":\"An unexpected error occurred.\"}

","urlObject":{"path":["remittance","orders","v1"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"ec348d63-d813-4c89-8cf5-76fbf8f48916","name":"Get All Orders - 200","originalRequest":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{getOrdersSignature}}","description":"Signature Request","type":"text"},{"key":"X-Request-Timestamp","value":"{{getOrdersTimestamp}}","description":"Timestamp","type":"text"},{"key":"X-Request-publicKey","value":"{{publicKey}}","description":"B2B Public Key","type":"text"}],"url":"{{url}}/remittance/orders/v1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"733"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 23 Feb 2024 21:32:04 GMT"},{"key":"X-Request-Id","value":"082289f2-3bed-4447-bc9d-996b01abf0ad"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": \"2048bea9-d292-11ee-9839-0242ac12000d\",\n \"quoteId\": \"01ecd7f5-d292-11ee-9839-0242ac12000d\",\n \"receivingCurrency\": \"USD\",\n \"receivingAmount\": 26.4166,\n \"receivingCountry\": \"\",\n \"sendingCurrency\": \"PEN\",\n \"sendingAmount\": 100,\n \"sendingCountry\": \"PER\",\n \"feeAmount\": 0,\n \"exchangeRate\": 3.7855,\n \"statusOrder\": \"CREATED\",\n \"createdDatetime\": \"2024-02-23\",\n \"expirationDatetime\": \"2024-02-23\"\n },\n {\n \"id\": \"5205cac2-d273-11ee-9839-0242ac12000d\",\n \"quoteId\": \"3e9234a0-d273-11ee-9839-0242ac12000d\",\n \"receivingCurrency\": \"USD\",\n \"receivingAmount\": 132.0829,\n \"receivingCountry\": \"\",\n \"sendingCurrency\": \"PEN\",\n \"sendingAmount\": 500,\n \"sendingCountry\": \"PER\",\n \"feeAmount\": 0,\n \"exchangeRate\": 3.7855,\n \"statusOrder\": \"CREATED\",\n \"createdDatetime\": \"2024-02-23\",\n \"expirationDatetime\": \"2024-02-23\"\n }\n ]\n}"},{"id":"da471a9a-9b04-42c7-aa95-46a483a2b61e","name":"404 Error","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"","description":"Signature Request","type":"text"},{"key":"X-Request-Timestamp","value":"","description":"Timestamp","type":"text"},{"key":"X-Request-publicKey","value":"","description":"B2B Public Key","type":"text"}],"body":{"mode":"raw","raw":"{\n \"receivingCurrency\": \"USD\",\n \"sendingAmount\": 500,\n \"sendingCountry\": \"PER\",\n \"sendingCurrency\": \"PEN\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/orders/v1/quote"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 16 Feb 2024 22:50:21 GMT"},{"key":"X-Request-Id","value":"69ac09e8-a303-487d-9fd4-05a5d771a933"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"MoleculerError\",\n \"message\": \"There is no merchant associated with the public key.\",\n \"code\": 404,\n \"type\": \"ValidationMerchantPublicKeyNotExistError\"\n}"}],"_postman_id":"a1a057fa-5c0c-405f-9149-f154424fb446"},{"name":"Payment Notification","id":"d091c87f-5758-42dd-b140-a10f01a0a059","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"merchantReference\": \"MERCHANT00000628\",\r\n \"status\": \"B89_PAID\",\r\n \"orderId\": \"8ae4697d-dcdc-11ee-9e60-0242ac120008\",\r\n \"comment\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url_payout_notification}}","description":"

When B89 receives a notification of a processed transaction (payment approved or denied), B89 will notify the merchant's POST URL.

To do this, the merchant must provide B89 with a public URL (HTTPS) of POST type and the necessary HEADERS, for example: 'Authorization: Bearer token'.

It is not mandatory to send headers but for security we always suggest adding an authentication token.

The service behind the shared URL can be coded in any programming language, but must respond using a standard format (REST API).

\n
Note:
url_payout_notification: It is the url that the dealer shares with b89 to configure our environment and send notifications of processed transactions.
\n

B89 WILL PUBLISH the following information at the URL:

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
orderId	String	Created order id
merchantReference	String	Reference number for each collection. Used to notify merchants about a payment
status	String	Payout status description. In case of success: B2B_PAID In case of any error: B2B_PAYMENT_ERROR
comment	String	Error reason in case of B2B_PAYMENT_ERROR

Response:
B89 expects a 200 HTTP code by response to confirm delivery of the notification.

\n","urlObject":{"host":["{{url_payout_notification}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"d091c87f-5758-42dd-b140-a10f01a0a059"}],"id":"066b5522-bab2-4b18-9380-34de7f0e1a9b","description":"

The image below presents the ordinal or common states involved in the order creation flow.

\n\n $\"API%20Sequence\"$ \n\n

Conventions

Client - Client application.
\n
Status - HTTP status code of response.
\n
All the possible responses are listed under ‘Responses’ for each method. Only one of them is issued per request server.
\n
All response are in JSON format.
\n
All request parameters are mandatory unless explicitly marked as [optional]
\n
The type of values accepted for a request parameter are shown the the values column like this [10|] .The | symbol means OR. If the parameter is [optional], the default value is shown in blue bold text, as 10 is written in [10|].
\n

Status Codes

All status codes are standard HTTP status codes. The below ones are used in this API.

2XX - Success of some kind

4XX - Error occurred in client’s part

5XX - Error occurred in server’s part

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status Code	Description
200	OK
201	Created
202	Accepted (Request accepted, and queued for execution)
400	Bad Request
401	Authentication Failure
403	Forbidden
404	Resource Not Found
405	Method Not Allowed
409	Conflict
412	Precondition Failed
413	Request Entity Too Large
500	Internal Server Error
501	Not Implemented
503	Service Unavailable

","_postman_id":"066b5522-bab2-4b18-9380-34de7f0e1a9b"},{"name":"Wallets","item":[{"name":"Create wallet","event":[{"listen":"prerequest","script":{"id":"3572240f-e0f0-4bda-9b44-75d333887584","exec":["let privateKey = pm.environment.get(\"privateKey\");\r","\r","pm.sendRequest({\r"," url: 'https://uat-apipayments.b89.io/merchants/v1/sign',\r"," method: 'POST',\r"," header: {\r"," 'Content-Type': 'application/json'\r"," },\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," \"secretKey\": \"secret-test\",\r"," \"privateKey\": privateKey,\r"," \"queryString\": {},\r"," \"body\": {\r"," \"walletType\": \"PAYIN\",\r"," \"clientType\": \"MERCHANT\",\r"," \"currency\": \"PEN\",\r"," \"externalReference\": \"uuid-test-1\"\r"," }\r"," })\r"," }\r","}, (err, res) => {\r"," if (err) {\r"," console.error(err);\r"," } else {\r"," const resp = res.json();\r"," pm.environment.set(\"signatureSTG\", resp.signature);\r"," pm.environment.set(\"timestampSTG\", resp.timestamp);\r"," }\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"8701f57a-09e4-4631-a349-6d561f97e9be","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Request-Signature","value":"{{signatureSTG}}","description":"

Required for security validation. A cryptographic signature generated using your private key.

\n","type":"text"},{"key":"X-Request-Timestamp","value":"{{timestampSTG}}","description":"

Prevents replay attacks. Must be the current Unix timestamp in milliseconds.

\n","type":"text"},{"key":"X-Request-publicKey","value":"{{publickeySTG}}","description":"

Your public key for authentication and verification.

\n","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"walletType\": \"PAYIN\",\r\n \"clientType\": \"MERCHANT\",\r\n \"currency\": \"PEN\",\r\n \"externalReference\": \"uuid-test-1\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/wallets/v1/wallet","description":"

This endpoint allows you to create a wallet to manage financial transactions. A wallet is linked to a client and has a specific currency. The wallet type defines whether it is used for payouts, or pay-ins

Request body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
walletType	string	true	Specifies the wallet type. Possible values: - REMITTANCE: For international payout transactions. - PAYOUT: For outgoing payments. - PAYIN: For incoming payments.
clientType	string	true	Defines the client type. Possible values: - MERCHANT: For businesses. - BUSINESS: For corporate accounts.
currency	string	true	The currency used for the wallet. Possible values: - PEN (Peruvian Sol) - USD (US Dollar)
externalReference	string	true	A unique identifier for the wallet, usually a UUID or tracking reference. Example: \"uuid-test-1\"

Response body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
id	string	Unique identifier for the created wallet.
amountAvailable	number	Current balance available in the wallet. It starts at 0 and changes based on transactions.
amountLocked	number	Amount that is reserved or on hold.
clientType	string	Defines the type of client. Possible values: MERCHANT (for businesses).
createdDatetime	string	Timestamp of when the wallet was created (in UTC format).
currency	string	Currency associated with the wallet. Possible values: PEN (Peruvian Sol), USD (US Dollar).
externalReference	string	Unique identifier for the wallet, typically a UUID or a tracking reference provided in the request.
merchantId	string	Unique identifier of the merchant associated with the wallet.
updatedDatetime	string	Timestamp of the last update made to the wallet.
walletType	string	Defines the type of wallet. Possible values: REMITTANCE, PAYOUT, PAYIN.

","urlObject":{"path":["wallets","v1","wallet"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"14759b47-9306-47dc-810b-d19653a1df73","name":"Create wallet","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"{{signatureSTG}}"},{"key":"X-Request-Timestamp","value":"{{timestampSTG}}"},{"key":"X-Request-publicKey","value":"{{publickeySTG}}"}],"body":{"mode":"raw","raw":"{\r\n \"walletType\": \"PAYIN\",\r\n \"clientType\": \"MERCHANT\",\r\n \"currency\": \"PEN\",\r\n \"externalReference\": \"uuid-test-1\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/wallets/v1/wallet"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"id\": \"732ab4b9-f20b-11ee-9737-0242ac120007\",\r\n \"amountAvailable\": 0,\r\n \"amountLocked\": 0,\r\n \"clientType\": \"MERCHANT\",\r\n \"createdDatetime\": \"2024-03-26 23:18:49.000000\",\r\n \"currency\": \"PEN\",\r\n \"externalReference\": \"uuid-test-4\",\r\n \"merchantId\": \"9189b1ec-402c-4ad0-90ca-a9df27b0714f\",\r\n \"updatedDatetime\": \"2024-03-26 23:18:49.000000\",\r\n \"walletType\": \"PAYIN\"\r\n }\r\n}"}],"_postman_id":"8701f57a-09e4-4631-a349-6d561f97e9be"},{"name":"Get wallet by id","event":[{"listen":"prerequest","script":{"id":"080d632d-96d5-4f4e-8eb3-a3e2c2b3a2f7","exec":["let privateKey = pm.environment.get(\"privateKey\");\r","let signUrl = pm.environment.get(\"sign_url\");\r","\r","pm.sendRequest({\r"," url: signUrl,\r"," method: 'POST',\r"," header: {\r"," 'Content-Type': 'application/json'\r"," },\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," \"secretKey\": \"secret-test\",\r"," \"privateKey\": privateKey,\r"," \"queryString\": {\r"," \"walletId\": \"732ab4b9-f20b-11ee-9737-0242ac120007\",\r"," },\r"," \"body\": {}\r"," })\r"," }\r","}, (err, res) => {\r"," if (err) {\r"," console.error(err);\r"," } else {\r"," const resp = res.json();\r"," pm.environment.set(\"signatureSTG\", resp.signature);\r"," pm.environment.set(\"timestampSTG\", resp.timestamp);\r"," }\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"b801a273-1576-49a2-8874-dda3e69bbba3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{signatureSTG}}","description":"

Required for security validation. A cryptographic signature generated using your private key.

\n"},{"key":"X-Request-Timestamp","value":"{{timestampSTG}}","description":"

Prevents replay attacks. Must be the current Unix timestamp (in milliseconds).

\n"},{"key":"X-Request-publicKey","value":"{{publickeySTG}}","description":"

Your public key, used to verify your identity in the request.

\n"}],"url":"{{url}}/wallets/v1/wallet/:walletId","description":"

This endpoint retrieves the details of a specific wallet by its unique walletId. The response includes information such as the available balance, locked amount, client type, currency, and timestamps.

Path variables detail

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
walletId	string (UUID)	true	Unique identifier of the wallet. This ID is obtained from the response of the POST /wallets/v1/wallet endpoint. Example: 732ab4b9-f20b-11ee-9737-0242ac120007.

Response body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
id	string	Unique identifier for the wallet.
amountAvailable	number	Current balance available in the wallet.
amountLocked	number	Amount that is reserved or on hold, preventing immediate use.
clientType	string	Defines the type of client. Possible values: - MERCHANT: For business users.
createdDatetime	string (ISO Date)	Timestamp of when the wallet was created (UTC format).
currency	string	Currency of the wallet. Possible values: - PEN: Peruvian Sol - USD: US Dollar
externalReference	string	Unique reference ID provided when creating the wallet.
merchantId	string (UUID)	Unique identifier of the merchant associated with the wallet.
updatedDatetime	string (ISO Date)	Timestamp of the last update made to the wallet.
walletType	string	Defines the type of wallet. Possible values: - REMITTANCE: For international payout transactions. - PAYOUT: For outgoing payments. - PAYIN: For incoming payments.

","urlObject":{"path":["wallets","v1","wallet",":walletId"],"host":["{{url}}"],"query":[],"variable":[{"type":"any","value":"732ab4b9-f20b-11ee-9737-0242ac120007","key":"walletId"}]}},"response":[{"id":"0d85786f-af67-40c3-ae59-43e4006cdea3","name":"200 OK","originalRequest":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{signatureSTG}}"},{"key":"X-Request-Timestamp","value":"{{timestampSTG}}"},{"key":"X-Request-publicKey","value":"{{publickeySTG}}"}],"url":{"raw":"{{url}}/wallets/v1/wallet/:walletId","host":["{{url}}"],"path":["wallets","v1","wallet",":walletId"],"variable":[{"key":"walletId","value":"732ab4b9-f20b-11ee-9737-0242ac120007"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 04 Apr 2024 00:44:10 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-request-id","value":"5c24b836-0cdf-4bf9-a17e-929efacd0e9a"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=EPq%2B7VL9D%2FqbecJDuekJ4n%2BRRw9d%2FJvMkVemOnfKLvvK4kD076rlmzv1413cI2%2FFm7%2BYvVB4MBC43LFtjQ22ZbOJo6zUBIqLdQ9Nwu53sX4nIq2CEj7aNWQh7O%2FMHYQyTDbbSCh%2Fo2fd\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"86ed44b82a809c2a-IAD"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": \"732ab4b9-f20b-11ee-9737-0242ac120007\",\n \"amountAvailable\": 250.52,\n \"amountLocked\": 0,\n \"clientType\": \"MERCHANT\",\n \"createdDatetime\": \"2024-04-03 17:42:28.000000\",\n \"currency\": \"PEN\",\n \"externalReference\": \"uuid-test-1\",\n \"merchantId\": \"eac0340c-84d8-4e5a-a077-83cf14eebed9\",\n \"updatedDatetime\": \"2024-04-03 17:42:28.000000\",\n \"walletType\": \"PAYIN\"\n }\n ]\n}"}],"_postman_id":"b801a273-1576-49a2-8874-dda3e69bbba3"},{"name":"Get wallets","event":[{"listen":"prerequest","script":{"id":"04ecb3f5-fbdc-4f7d-9dd1-a7ff3e70766f","exec":["let privateKey = pm.environment.get(\"privateKey\");\r","let signUrl = pm.environment.get(\"sign_url\");\r","\r","pm.sendRequest({\r"," url: signUrl,\r"," method: 'POST',\r"," header: {\r"," 'Content-Type': 'application/json'\r"," },\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," \"secretKey\": \"secret-test\",\r"," \"privateKey\": privateKey,\r"," \"queryString\": {\r"," \"walletType\": \"PAYIN\",\r"," \"clientType\": \"MERCHANT\",\r"," \"currency\": \"PEN\",\r"," \"externalReference\": \"uuid-test-1\",\r"," \"page\": \"5\",\r"," \"limit\": \"5\",\r"," },\r"," \"body\": {}\r"," })\r"," }\r","}, (err, res) => {\r"," if (err) {\r"," console.error(err);\r"," } else {\r"," const resp = res.json();\r"," pm.environment.set(\"signatureSTG\", resp.signature);\r"," pm.environment.set(\"timestampSTG\", resp.timestamp);\r"," }\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"23eea16d-611a-4cae-8b4c-332a705bf40e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{signatureSTG}}","description":"

Required for security validation. A cryptographic signature generated using your private key.

\n"},{"key":"X-Request-Timestamp","value":"{{timestampSTG}}","description":"

Prevents replay attacks. Must be the current Unix timestamp (in milliseconds).

\n"},{"key":"X-Request-publicKey","value":"{{publickeySTG}}","description":"

Your public key, used to verify your identity in the request.

\n"}],"url":"{{url}}/wallets/v1/wallet?walletType=PAYIN&clientType=MERCHANT¤cy=PEN&externalReference=uuid-test-1&page=5&limit=5","description":"

This endpoint retrieves a list of wallets based on the provided filters. You can filter results by walletType, clientType, currency, and externalReference. Pagination is supported using page and limit parameters.

Filters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
walletType	string	true	Defines the type of wallet. Possible values: - REMITTANCE: For international payout transactions. - PAYOUT: For outgoing payments. - PAYIN: For incoming payments.
clientType	string	true	Defines the type of client. Possible values: - MERCHANT: Business clients. - BUSINESS: Corporate accounts. - NATURAL: Individual users.
currency	string	true	Currency associated with the wallet. Possible values: - PEN: Peruvian Sol. - USD: US Dollar.
externalReference	string	true	A unique identifier for the wallet, typically a UUID or a tracking reference.
page	string	false	The page number for paginated results. Defaults to 0 if not specified.
limit	string	false	Maximum number of results per page (e.g., 5).

Response body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
id	string	Unique identifier for the wallet.
merchantId	string	Unique identifier of the merchant associated with the wallet.
walletType	string	Defines the type of wallet. Possible values: - REMITTANCE: For international payout transactions. - PAYOUT: For outgoing payments. - PAYIN: For incoming payments.
currency	string	Currency associated with the wallet. Possible values: - PEN: Peruvian Sol. - USD: US Dollar.
amountAvailable	number	The current available balance in the wallet.
amountLocked	number	Amount that is reserved or on hold.
externalReference	string	The reference ID provided when creating the wallet.
clientType	string	Defines the type of client. Possible values: - MERCHANT: Business clients. - BUSINESS: Corporate accounts. - NATURAL: Individual users.

","urlObject":{"path":["wallets","v1","wallet"],"host":["{{url}}"],"query":[{"description":{"content":"

(\"REMITTANCE\", \"PAYIN\", \"PAYOUT\")

\n","type":"text/plain"},"key":"walletType","value":"PAYIN"},{"description":{"content":"

(\"BUSINESS\", \"MERCHANT\", \"NATURAL\")

\n","type":"text/plain"},"key":"clientType","value":"MERCHANT"},{"description":{"content":"

(\"USD\", \"PEN\")

\n","type":"text/plain"},"key":"currency","value":"PEN"},{"key":"externalReference","value":"uuid-test-1"},{"key":"page","value":"5"},{"key":"limit","value":"5"}],"variable":[]}},"response":[{"id":"149145ea-22f4-4a5c-b51d-f0f56d5d88d3","name":"200 OK","originalRequest":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{signatureSTG}}"},{"key":"X-Request-Timestamp","value":"{{timestampSTG}}"},{"key":"X-Request-publicKey","value":"{{publickeySTG}}"}],"url":{"raw":"{{url}}/wallets/v1/wallet?walletType=PAYIN&clientType=MERCHANT¤cy=PEN&externalReference=uuid-test-1&page=5&limit=5","host":["{{url}}"],"path":["wallets","v1","wallet"],"query":[{"key":"walletType","value":"PAYIN"},{"key":"clientType","value":"MERCHANT"},{"key":"currency","value":"PEN"},{"key":"externalReference","value":"uuid-test-1"},{"key":"page","value":"5"},{"key":"limit","value":"5"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 04 Apr 2024 01:01:40 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"11"},{"key":"Connection","value":"keep-alive"},{"key":"x-request-id","value":"bfc7f9c7-c619-4bc5-83af-0b806c04b173"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=7612T%2B6OEVapUpSGuHAAZXY7gJANBq5Y%2FrHrBlsRXwVFBawHNXOS5xVIPoOYzldSBxkigY0BaMfMNXupgZd5XPo80YF0%2FQtzP38HcVOW3b2mwjLP9YW7zfS2K6rW2MeUmqJOEpVslIYI\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"86ed5e5adc805997-IAD"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": []\n}"}],"_postman_id":"23eea16d-611a-4cae-8b4c-332a705bf40e"},{"name":"Create wallet transaction","event":[{"listen":"prerequest","script":{"id":"e2253e20-78fb-4856-ad54-24e291e8763b","exec":["let privateKey = pm.environment.get(\"privateKey\");\r","let signUrl = pm.environment.get(\"sign_url\");\r","\r","pm.sendRequest({\r"," url: signUrl,\r"," method: 'POST',\r"," header: {\r"," 'Content-Type': 'application/json'\r"," },\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," \"secretKey\": \"secret-test\",\r"," \"privateKey\": privateKey,\r"," \"queryString\": {\r"," \"walletId\": \"732ab4b9-f20b-11ee-9737-0242ac120007\",\r"," },\r"," \"body\": {\r"," \"walletType\": \"PAYIN\",\r"," \"externalReference\": \"uuid-test-4\",\r"," \"externalType\": \"REMITTANCE_PAYOUT\",\r"," \"transactionType\": \"CREDIT\",\r"," \"description\": \"Test transaction wallet\",\r"," \"metadata\": \"Test metadata\",\r"," \"amount\": 60.52,\r"," \"toLocked\": 1\r"," } \r"," })\r"," }\r","}, (err, res) => {\r"," if (err) {\r"," console.error(err);\r"," } else {\r"," const resp = res.json();\r"," pm.environment.set(\"signatureSTG\", resp.signature);\r"," pm.environment.set(\"timestampSTG\", resp.timestamp);\r"," }\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"06c610f8-1ed2-4554-8aeb-f02ac5308db9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Request-Signature","value":"{{signatureSTG}}"},{"key":"X-Request-Timestamp","value":"{{timestampSTG}}"},{"key":"X-Request-publicKey","value":"{{publickeySTG}}"}],"body":{"mode":"raw","raw":"{\r\n \"walletType\": \"PAYIN\",\r\n \"externalReference\": \"uuid-test-4\",\r\n \"externalType\": \"REMITTANCE_PAYOUT\",\r\n \"transactionType\": \"CREDIT\",\r\n \"description\": \"Test transaction wallet\",\r\n \"metadata\": \"Test metadata\",\r\n \"amount\": 60.52,\r\n \"toLocked\": 1\r\n} ","options":{"raw":{"language":"json"}}},"url":"{{url}}/wallets/v1/wallet/:walletId/transaction","urlObject":{"path":["wallets","v1","wallet",":walletId","transaction"],"host":["{{url}}"],"query":[],"variable":[{"type":"any","value":"732ab4b9-f20b-11ee-9737-0242ac120007","key":"walletId"}]}},"response":[{"id":"a09997a6-6c46-451c-8326-0871fd968e59","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"{{signatureSTG}}"},{"key":"X-Request-Timestamp","value":"{{timestampSTG}}"},{"key":"X-Request-publicKey","value":"{{publickeySTG}}"}],"body":{"mode":"raw","raw":"{\r\n \"walletType\": \"PAYIN\",\r\n \"externalReference\": \"uuid-test-4\",\r\n \"externalType\": \"REMITTANCE_PAYOUT\",\r\n \"transactionType\": \"CREDIT\",\r\n \"description\": \"Test transaction wallet\",\r\n \"metadata\": \"Test metadata\",\r\n \"amount\": 50.52,\r\n \"toLocked\": 0\r\n} ","options":{"raw":{"language":"json"}}},"url":{"raw":"{{url}}/wallets/v1/wallet/:walletId/transaction","host":["{{url}}"],"path":["wallets","v1","wallet",":walletId","transaction"],"variable":[{"key":"walletId","value":"732ab4b9-f20b-11ee-9737-0242ac120007"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 04 Apr 2024 00:47:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-request-id","value":"d05af6b2-2c8e-40dd-b5ce-5b1557a245e4"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=mEtQRHp6PmMqRHpRYmynQgPn1uH861pdSJ1a0HpEKdExxuuw2rf2mpYSlBWaskU4kT7oNdkYjpySLodEI4MUIZPgHqZzAvN%2BftqJvlvVrHRbkImGN6KS5wcyRwKPBd3uzHEipDRlrf%2Fa\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"86ed498c5ff4242d-IAD"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": \"e99b1d72-f21c-11ee-9737-0242ac120007\",\n \"amount\": 50.52,\n \"createdDatetime\": \"2024-04-03 19:47:28.000000\",\n \"currency\": \"PEN\",\n \"currentWalletAmountAvailable\": 250.52,\n \"currentWalletAmountLocked\": 0,\n \"description\": \"Test transaction wallet\",\n \"externalReference\": \"uuid-test-4\",\n \"externalType\": \"REMITTANCE_PAYOUT\",\n \"merchantId\": \"eac0340c-84d8-4e5a-a077-83cf14eebed9\",\n \"metadata\": \"Test metadata\",\n \"newWalletAmountAvailable\": 301.04,\n \"newWalletAmountLocked\": 0,\n \"status\": \"PROCESSED\",\n \"transactionType\": \"CREDIT\",\n \"updatedDatetime\": \"2024-04-03 19:47:28.000000\",\n \"walletId\": \"732ab4b9-f20b-11ee-9737-0242ac120007\",\n \"walletType\": \"PAYIN\"\n }\n ]\n}"}],"_postman_id":"06c610f8-1ed2-4554-8aeb-f02ac5308db9"},{"name":"Get wallet transaction by id","event":[{"listen":"prerequest","script":{"id":"91a4edda-5722-41ca-a596-0d9efdc1bdc6","exec":["let privateKey = pm.environment.get(\"privateKey\");\r","let signUrl = pm.environment.get(\"sign_url\");\r","\r","pm.sendRequest({\r"," url: signUrl,\r"," method: 'POST',\r"," header: {\r"," 'Content-Type': 'application/json'\r"," },\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," \"secretKey\": \"secret-test\",\r"," \"privateKey\": privateKey,\r"," \"queryString\": {\r"," \"walletTransactionId\": \"089c8d4a-f21e-11ee-9737-0242ac120007\",\r"," },\r"," \"body\": {}\r"," })\r"," }\r","}, (err, res) => {\r"," if (err) {\r"," console.error(err);\r"," } else {\r"," const resp = res.json();\r"," pm.environment.set(\"signatureSTG\", resp.signature);\r"," pm.environment.set(\"timestampSTG\", resp.timestamp);\r"," }\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"b024ce74-f352-463d-92ef-86b8f2a2067f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{signatureSTG}}"},{"key":"X-Request-Timestamp","value":"{{timestampSTG}}"},{"key":"X-Request-publicKey","value":"{{publickeySTG}}"}],"url":"{{url}}/wallets/v1/transaction/:walletTransactionId","urlObject":{"path":["wallets","v1","transaction",":walletTransactionId"],"host":["{{url}}"],"query":[],"variable":[{"type":"any","value":"089c8d4a-f21e-11ee-9737-0242ac120007","key":"walletTransactionId"}]}},"response":[{"id":"679fdac7-e279-4a83-b9f3-853bfbf5a0d7","name":"200 OK","originalRequest":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{signatureSTG}}"},{"key":"X-Request-Timestamp","value":"{{timestampSTG}}"},{"key":"X-Request-publicKey","value":"{{publickeySTG}}"}],"url":{"raw":"{{url}}/wallets/v1/transaction/:walletTransactionId","host":["{{url}}"],"path":["wallets","v1","transaction",":walletTransactionId"],"variable":[{"key":"walletTransactionId","value":"e99b1d72-f21c-11ee-9737-0242ac120007"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 04 Apr 2024 00:49:27 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-request-id","value":"a33a9a45-8782-4d21-95b1-e2cf9f7f3321"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=xzgE6oI%2B4%2FdCORQQfNwfwHDy%2BzP1YjxsLHULlKmEgf0Dai1hdSLjg%2FzY7t7JB6NiKOtgfCOT2anFAiNJbFqmJZJzmmcsPcdnVS4%2Fncb8xaIM1lHR1ySKSGW5iure7fgKdskF6T7BWO7H\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"86ed4c7508165a45-IAD"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"id\": \"e99b1d72-f21c-11ee-9737-0242ac120007\",\n \"amount\": 50.52,\n \"createdDatetime\": \"2024-04-03T19:47:28.000Z\",\n \"currency\": \"PEN\",\n \"currentWalletAmountAvailable\": 250.52,\n \"currentWalletAmountLocked\": 0,\n \"description\": \"Test transaction wallet\",\n \"externalReference\": \"uuid-test-4\",\n \"externalType\": \"REMITTANCE_PAYOUT\",\n \"merchantId\": \"eac0340c-84d8-4e5a-a077-83cf14eebed9\",\n \"metadata\": \"Test metadata\",\n \"newWalletAmountAvailable\": 301.04,\n \"newWalletAmountLocked\": 0,\n \"status\": \"PROCESSED\",\n \"transactionType\": \"CREDIT\",\n \"updatedDatetime\": \"2024-04-03T19:47:28.000Z\",\n \"walletId\": \"732ab4b9-f20b-11ee-9737-0242ac120007\",\n \"walletType\": \"PAYIN\"\n }\n}"}],"_postman_id":"b024ce74-f352-463d-92ef-86b8f2a2067f"},{"name":"Update wallet transaction","event":[{"listen":"prerequest","script":{"id":"9e23b6e4-fb89-4d0f-a3ef-d5693c8f8340","exec":["let privateKey = pm.environment.get(\"privateKey\");\r","let signUrl = pm.environment.get(\"sign_url\");\r","\r","pm.sendRequest({\r"," url: signUrl,\r"," method: 'POST',\r"," header: {\r"," 'Content-Type': 'application/json'\r"," },\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," \"secretKey\": \"secret-test\",\r"," \"privateKey\": privateKey,\r"," \"queryString\": {\r"," \"walletTransactionId\": \"089c8d4a-f21e-11ee-9737-0242ac120007\"\r"," },\r"," \"body\": {\r"," \"status\": \"BLOCKED_CANCELED\"\r"," }\r"," })\r"," }\r","}, (err, res) => {\r"," if (err) {\r"," console.error(err);\r"," } else {\r"," const resp = res.json();\r"," pm.environment.set(\"signatureSTG\", resp.signature);\r"," pm.environment.set(\"timestampSTG\", resp.timestamp);\r"," }\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"05a2bb76-c1b1-4f2d-b707-adec0affa56d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-Request-Signature","value":"{{signatureSTG}}"},{"key":"X-Request-Timestamp","value":"{{timestampSTG}}"},{"key":"X-Request-publicKey","value":"{{publickeySTG}}"}],"body":{"mode":"raw","raw":"{\r\n \"status\": \"BLOCKED_CANCELED\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/wallets/v1/transaction/:walletTransactionId/status","urlObject":{"path":["wallets","v1","transaction",":walletTransactionId","status"],"host":["{{url}}"],"query":[],"variable":[{"type":"any","value":"089c8d4a-f21e-11ee-9737-0242ac120007","key":"walletTransactionId"}]}},"response":[{"id":"4790e30a-3144-482d-b0b0-9ac163ead6b2","name":"200 OK","originalRequest":{"method":"PATCH","header":[{"key":"X-Request-Signature","value":"{{signatureSTG}}"},{"key":"X-Request-Timestamp","value":"{{timestampSTG}}"},{"key":"X-Request-publicKey","value":"{{publickeySTG}}"}],"body":{"mode":"raw","raw":"{\r\n \"status\": \"BLOCKED_CANCELED\"\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{url}}/wallets/v1/transaction/:walletTransactionId/status","host":["{{url}}"],"path":["wallets","v1","transaction",":walletTransactionId","status"],"variable":[{"key":"walletTransactionId","value":"089c8d4a-f21e-11ee-9737-0242ac120007"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 04 Apr 2024 00:59:11 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-request-id","value":"7fd9f0cc-54ae-4e5d-b821-d32dba76982d"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=aim%2Fa7bj5oezUxW8VXfAwuIVpBkB3JEFAGejOiUOuvae4oRIKVjawPtgs2pL6k7BTyX9IeJYWeLNpisBfY9rIABtewDiUYg6tLLTNdHLy3Oxe2gsbunQwRekX5npy5ql3sL3yw4Q4Jon\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"86ed5ab33eb80623-IAD"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": \"089c8d4a-f21e-11ee-9737-0242ac120007\",\n \"amount\": 60.52,\n \"createdDatetime\": \"2024-04-03 19:55:30.000000\",\n \"currency\": \"PEN\",\n \"currentWalletAmountAvailable\": 301.04,\n \"currentWalletAmountLocked\": 0,\n \"description\": \"Test transaction wallet\",\n \"externalReference\": \"uuid-test-4\",\n \"externalType\": \"REMITTANCE_PAYOUT\",\n \"merchantId\": \"eac0340c-84d8-4e5a-a077-83cf14eebed9\",\n \"metadata\": \"Test metadata\",\n \"newWalletAmountAvailable\": 301.04,\n \"newWalletAmountLocked\": 0,\n \"status\": \"BLOCKED_CANCELED\",\n \"transactionType\": \"CREDIT\",\n \"updatedDatetime\": \"2024-04-03 19:55:30.000000\",\n \"walletId\": \"732ab4b9-f20b-11ee-9737-0242ac120007\",\n \"walletType\": \"PAYIN\"\n }\n ]\n}"}],"_postman_id":"05a2bb76-c1b1-4f2d-b707-adec0affa56d"},{"name":"Get wallet transactions","event":[{"listen":"prerequest","script":{"id":"d94b4d9d-e000-4fd6-95ef-505b12d397c6","exec":["let privateKey = pm.environment.get(\"privateKey\");\r","let signUrl = pm.environment.get(\"sign_url\");\r","\r","pm.sendRequest({\r"," url: signUrl,\r"," method: 'POST',\r"," header: {\r"," 'Content-Type': 'application/json'\r"," },\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," \"secretKey\": \"secret-test\",\r"," \"privateKey\": privateKey,\r"," \"queryString\": {\r"," \"walletId\": \"9af45107-0405-11f0-bef0-0242ac120003\",\r"," \"transactionType\": [\"CREDIT\"],\r"," \"status\": [\"PROCESSED\"],\r"," \"page\": 1,\r"," \"limit\": 3\r"," },\r"," \"body\": {}\r"," })\r"," }\r","}, (err, res) => {\r"," if (err) {\r"," console.error(err);\r"," } else {\r"," const resp = res.json();\r"," pm.environment.set(\"signatureSTG\", resp.signature);\r"," pm.environment.set(\"timestampSTG\", resp.timestamp);\r"," }\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"c902272e-3bf3-46cb-bd53-3e94fc270be2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{signatureSTG}}","description":"

Required for security validation. A cryptographic signature generated using your private key.

\n"},{"key":"X-Request-Timestamp","value":"{{timestampSTG}}","description":"

Prevents replay attacks. Must be the current Unix timestamp (in milliseconds).

\n"},{"key":"X-Request-publicKey","value":"{{publickeySTG}}","description":"

Your public key, used to verify your identity in the request.

\n"}],"body":{"mode":"raw","raw":"{\r\n \"walletId\": \"9af45107-0405-11f0-bef0-0242ac120003\",\r\n \"transactionType\": [\r\n \"CREDIT\"\r\n ],\r\n \"status\": [\r\n \"PROCESSED\"\r\n ],\r\n \"page\": 1,\r\n \"limit\": 3\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/wallets/v1/wallet/transactions","description":"

This endpoint allows retrieving the transaction history of a specific wallet, which is essential for conducting audits or verifying financial movements. Properly validating responses and managing transaction statuses is crucial.

Request body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
walletId	string	true	Unique identifier of the wallet for which transactions are requested.
transactionId	string	false	Specific transaction ID to filter results.
externalType	string[]	false	Filters transactions by external type. Possible values: - REMITTANCE_PAYOUT: Outgoing remittance payment. - REMITTANCE_DEPOSIT: Incoming remittance deposit. - REMITTANCE_PAYOUT_REVERT: Reversal of a remittance payout. - REMITTANCE_FEE: Fee charged for remittance transactions. - SERVICE_CHARGE: Additional service-related charge. - PAYIN_DEPOSIT: Incoming payment deposit. - OTHERS: Any other type of external transaction. This parameter accepts an array of strings to filter multiple types in a single request.
transactionType	string[]	false	Filters transactions by type. Possible values: - CREDIT: Credit transactions. - DEBIT: Debit transactions. This parameter accepts an array of strings to filter multiple types in a single request.
status	string[]	false	Filters transactions by status. Possible values: - BLOCKED: Transaction is blocked. - PROCESSED: Transaction has been successfully processed. - BLOCKED_CANCELED: Blocked transaction that was later canceled. - FAILED: Transaction failed to complete. This parameter accepts an array of strings to filter multiple statuses in a single request.
page	number	false	Page number for pagination. Default: 1.
limit	number	false	Number of records per page. Default: 30.

Response body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
id	string	Unique transaction identifier.
amount	decimal	Transaction amount.
status	string	Transaction status. Possible values: PROCESSED, PENDING, FAILED.
currency	string	Currency of the transaction (ISO-4217). Possible values: - PEN: Peruvian Sol. - USD: US Dollar.
walletId	string	Wallet ID associated with the transaction.
transactionType	string	Transaction type. Possible values: CREDIT, DEBIT.
createdDatetime	string	Transaction creation date ISO string.
updatedDatetime	string	Last update date ISO string.
externalReference	string	External reference for the transaction.
newWalletAmountAvailable	decimal	Updated wallet balance after the transaction.
currentWalletAmountAvailable	decimal	Wallet balance before the transaction.

","urlObject":{"path":["wallets","v1","wallet","transactions"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"37d99a6b-3981-48b0-86cc-f510b4803aa3","name":"200 OK","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Request-Signature","value":"{{signatureSTG}}"},{"key":"X-Request-Timestamp","value":"{{timestampSTG}}"},{"key":"X-Request-publicKey","value":"{{publickeySTG}}"}],"body":{"mode":"raw","raw":"{\r\n \"walletId\": \"9af45107-0405-11f0-bef0-0242ac120003\",\r\n \"transactionType\": [\r\n \"CREDIT\"\r\n ],\r\n \"status\": [\r\n \"PROCESSED\"\r\n ],\r\n \"page\": 1,\r\n \"limit\": 3\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/wallets/v1/wallet/transactions"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"data\": [\r\n {\r\n \"id\": \"f437e453-043d-11f0-a25b-0242ac120002\",\r\n \"amount\": 100,\r\n \"status\": \"PROCESSED\",\r\n \"currency\": \"USD\",\r\n \"metadata\": \"\",\r\n \"walletId\": \"9af45107-0405-11f0-bef0-0242ac120003\",\r\n \"description\": \"\",\r\n \"merchantId\": \"b94f1278-6b22-4547-8fbb-21b0c04146b3\",\r\n \"walletType\": \"REMITTANCE\",\r\n \"externalType\": \"REMITTANCE_DEPOSIT\",\r\n \"createdDatetime\": \"2025-03-18 16:14:18.000000\",\r\n \"transactionType\": \"CREDIT\",\r\n \"updatedDatetime\": \"2025-03-18 16:14:18.000000\",\r\n \"externalReference\": \"\",\r\n \"orderCreatedDatetime\": \"2025-03-18 16:14:18.000000\",\r\n \"newWalletAmountLocked\": 0,\r\n \"newWalletAmountAvailable\": 111,\r\n \"currentWalletAmountLocked\": 0,\r\n \"currentWalletAmountAvailable\": 11\r\n },\r\n {\r\n \"id\": \"f2d23161-043d-11f0-a25b-0242ac120002\",\r\n \"amount\": 10,\r\n \"status\": \"PROCESSED\",\r\n \"currency\": \"USD\",\r\n \"metadata\": \"\",\r\n \"walletId\": \"9af45107-0405-11f0-bef0-0242ac120003\",\r\n \"description\": \"\",\r\n \"merchantId\": \"b94f1278-6b22-4547-8fbb-21b0c04146b3\",\r\n \"walletType\": \"REMITTANCE\",\r\n \"externalType\": \"REMITTANCE_DEPOSIT\",\r\n \"createdDatetime\": \"2025-03-18 16:14:16.000000\",\r\n \"transactionType\": \"CREDIT\",\r\n \"updatedDatetime\": \"2025-03-18 16:14:16.000000\",\r\n \"externalReference\": \"\",\r\n \"orderCreatedDatetime\": \"2025-03-18 16:14:16.000000\",\r\n \"newWalletAmountLocked\": 0,\r\n \"newWalletAmountAvailable\": 11,\r\n \"currentWalletAmountLocked\": 0,\r\n \"currentWalletAmountAvailable\": 1\r\n },\r\n {\r\n \"id\": \"f054f357-043d-11f0-a25b-0242ac120002\",\r\n \"amount\": 1,\r\n \"status\": \"PROCESSED\",\r\n \"currency\": \"USD\",\r\n \"metadata\": \"\",\r\n \"walletId\": \"9af45107-0405-11f0-bef0-0242ac120003\",\r\n \"description\": \"\",\r\n \"merchantId\": \"b94f1278-6b22-4547-8fbb-21b0c04146b3\",\r\n \"walletType\": \"REMITTANCE\",\r\n \"externalType\": \"REMITTANCE_DEPOSIT\",\r\n \"createdDatetime\": \"2025-03-18 16:14:12.000000\",\r\n \"transactionType\": \"CREDIT\",\r\n \"updatedDatetime\": \"2025-03-18 16:14:12.000000\",\r\n \"externalReference\": \"\",\r\n \"orderCreatedDatetime\": \"2025-03-18 16:14:12.000000\",\r\n \"newWalletAmountLocked\": 0,\r\n \"newWalletAmountAvailable\": 1,\r\n \"currentWalletAmountLocked\": 0,\r\n \"currentWalletAmountAvailable\": 0\r\n }\r\n ],\r\n \"page\": 1,\r\n \"limit\": 3,\r\n \"totalRows\": 3\r\n}"}],"_postman_id":"c902272e-3bf3-46cb-bd53-3e94fc270be2"}],"id":"727d08a1-e546-495d-bcc1-3bfc7b0290f5","description":" $\"API%20Sequence\"$ ","_postman_id":"727d08a1-e546-495d-bcc1-3bfc7b0290f5"},{"name":"Payins","item":[{"name":"Get countries","event":[{"listen":"prerequest","script":{"id":"96a44e49-4b1b-4b2c-b264-d9ef715fb33b","exec":["var requestDetails = {\r"," url: pm.environment.get(\"url\") + \"/merchants/v1/sign\",\r"," method: 'POST',\r"," header: 'Content-Type:application/json',\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," secretKey: pm.environment.get(\"secretKey\"),\r"," privateKey: pm.environment.get(\"certPrivateKey\"),\r"," queryString: {},\r"," body: JSON.parse(pm.variables.replaceIn(pm.request.body.raw))\r"," })\r"," }\r","};\r","\r","pm.sendRequest(requestDetails, function (err, response) {\r"," if (err) {\r"," console.log(err);\r"," } else {\r"," var responseData = response.json();\r"," console.log(responseData);\r"," var timestamp = responseData.timestamp;\r"," var signature = responseData.signature;\r","\r"," pm.environment.set(\"X_REQUEST_SIGNATURE\", timestamp);\r"," pm.environment.set(\"X_REQUEST_TIMESTAMP\", signature);\r"," }\r","});"],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"test","script":{"id":"655f3bee-d6c4-4d34-8bce-98ff3e4ec4f0","exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"f37331da-413e-45c1-94ce-70ac8da06b35","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{X_REQUEST_SIGNATURE}}"},{"key":"X-Request-Timestamp","value":"{{X_REQUEST_TIMESTAMP}}"},{"key":"X-Request-publicKey","value":"{{X_REQUEST_PUBLIC_KEY}}"}],"url":"{{url}}/payin/v1/countries","description":"

Gets the countries allowed by the B2B client.

Response Ok

Country array:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
isoCode	String	Iso code country.
country	String	Country by ISO code.

Responses Error

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Response
404	{\"type\":\"GetCountriesNotExistError\"}
401	{\"type\": \"ValidationMerchantInvalidTimestampError\"}
401	{\"type\": \"ValidationMerchantCredentialsDoesntMatchError\"}
401	{\"type\":\"ValidationMerchantUnauthorizedError\"}
500	{\"message\":\"An unexpected error occurred.\"}

","urlObject":{"path":["payin","v1","countries"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"01720572-b488-48f8-8bab-44484dd6dc2e","name":"200 Ok","originalRequest":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{signature}}"},{"key":"X-Request-Timestamp","value":"{{timestamp}}"},{"key":"X-Request-publicKey","value":"{{publicKey}}"}],"url":"{{api}}/payin/v1/countries"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"data\": [\r\n {\r\n \"isoCode\": \"ARG\",\r\n \"country\": \"Argentina\"\r\n },\r\n {\r\n \"isoCode\": \"PER\",\r\n \"country\": \"Peru\"\r\n }\r\n ]\r\n}"},{"id":"57a48111-170a-4180-b368-af9a4d9e9ef0","name":"404 Error","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"","description":"Signature Request"},{"key":"X-Request-Timestamp","value":"","description":"Timestamp"},{"key":"X-Request-publicKey","value":"","description":"B2B Public Key"}],"body":{"mode":"raw","raw":"{\n \"receivingCurrency\": \"USD\",\n \"sendingAmount\": 500,\n \"sendingCountry\": \"PER\",\n \"sendingCurrency\": \"PEN\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/orders/v1/quote"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 16 Feb 2024 22:50:21 GMT"},{"key":"X-Request-Id","value":"69ac09e8-a303-487d-9fd4-05a5d771a933"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"MoleculerError\",\n \"message\": \"There is no merchant associated with the public key.\",\n \"code\": 404,\n \"type\": \"ValidationMerchantPublicKeyNotExistError\"\n}"}],"_postman_id":"f37331da-413e-45c1-94ce-70ac8da06b35"},{"name":"Get routes by country","event":[{"listen":"prerequest","script":{"id":"e12630b4-ec55-49f0-8d65-eea3ed3d2934","exec":["var requestDetails = {\r"," url: pm.environment.get(\"url\") + \"/merchants/v1/sign\",\r"," method: 'POST',\r"," header: 'Content-Type:application/json',\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," secretKey: pm.environment.get(\"secretKey\"),\r"," privateKey: pm.environment.get(\"certPrivateKey\"),\r"," queryString: {},\r"," body: JSON.parse(pm.variables.replaceIn(pm.request.body.raw))\r"," })\r"," }\r","};\r","\r","pm.sendRequest(requestDetails, function (err, response) {\r"," if (err) {\r"," console.log(err);\r"," } else {\r"," var responseData = response.json();\r"," console.log(responseData);\r"," var timestamp = responseData.timestamp;\r"," var signature = responseData.signature;\r","\r"," pm.environment.set(\"X_REQUEST_SIGNATURE\", timestamp);\r"," pm.environment.set(\"X_REQUEST_TIMESTAMP\", signature);\r"," }\r","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"5da72d06-39de-49f5-89be-baf60db3fbab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{X_REQUEST_SIGNATURE}}","type":"text"},{"key":"X-Request-Timestamp","value":"{{X_REQUEST_TIMESTAMP}}","type":"text"},{"key":"X-Request-publicKey","value":"{{X_REQUEST_PUBLIC_KEY}}","type":"text"}],"url":"{{url}}/payin/v1/countries/:country/routes","description":"

Gets the routes by country.

Response Ok

Route array:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
id	String	Unique identifier of the Route.
nameRoute	String	Name of route.

Responses Error

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Response
404	{\"type\":\"GetRoutesByCountryNotExistError\"}
401	{\"type\": \"ValidationMerchantInvalidTimestampError\"}
401	{\"type\": \"ValidationMerchantCredentialsDoesntMatchError\"}
401	{\"type\":\"ValidationMerchantUnauthorizedError\"}
500	{\"message\":\"An unexpected error occurred.\"}

","urlObject":{"path":["payin","v1","countries",":country","routes"],"host":["{{url}}"],"query":[],"variable":[{"type":"any","value":"","key":"country"}]}},"response":[{"id":"e47a744b-d716-46fd-b434-3746776325fd","name":"200 Ok","originalRequest":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{signature}}"},{"key":"X-Request-Timestamp","value":"{{timestamp}}"},{"key":"X-Request-publicKey","value":"{{publicKey}}"}],"url":{"raw":"{{api}}/payin/v1/countries/:country/routes","host":["{{api}}"],"path":["payin","v1","countries",":country","routes"],"variable":[{"key":"country","value":""}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"data\": [\r\n {\r\n \"id\": \"ac68b648-d1e4-11ee-b537-0242ac150003\",\r\n \"nameRoute\": \"Route B\"\r\n }\r\n ]\r\n}"},{"id":"92c1cdb1-4a7c-42ca-99e9-0fe31f3ece75","name":"404 Error","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"","description":"Signature Request"},{"key":"X-Request-Timestamp","value":"","description":"Timestamp"},{"key":"X-Request-publicKey","value":"","description":"B2B Public Key"}],"body":{"mode":"raw","raw":"{\n \"receivingCurrency\": \"USD\",\n \"sendingAmount\": 500,\n \"sendingCountry\": \"PER\",\n \"sendingCurrency\": \"PEN\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/orders/v1/quote"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 16 Feb 2024 22:50:21 GMT"},{"key":"X-Request-Id","value":"69ac09e8-a303-487d-9fd4-05a5d771a933"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"MoleculerError\",\n \"message\": \"There is no merchant associated with the public key.\",\n \"code\": 404,\n \"type\": \"ValidationMerchantPublicKeyNotExistError\"\n}"}],"_postman_id":"5da72d06-39de-49f5-89be-baf60db3fbab"},{"name":"Get channel by country and route id","event":[{"listen":"prerequest","script":{"id":"33034655-16de-4994-8040-47e35645441b","exec":["var requestDetails = {\r"," url: pm.environment.get(\"url\") + \"/merchants/v1/sign\",\r"," method: 'POST',\r"," header: 'Content-Type:application/json',\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," secretKey: pm.environment.get(\"secretKey\"),\r"," privateKey: pm.environment.get(\"certPrivateKey\"),\r"," queryString: {},\r"," body: JSON.parse(pm.variables.replaceIn(pm.request.body.raw))\r"," })\r"," }\r","};\r","\r","pm.sendRequest(requestDetails, function (err, response) {\r"," if (err) {\r"," console.log(err);\r"," } else {\r"," var responseData = response.json();\r"," console.log(responseData);\r"," var timestamp = responseData.timestamp;\r"," var signature = responseData.signature;\r","\r"," pm.environment.set(\"X_REQUEST_SIGNATURE\", timestamp);\r"," pm.environment.set(\"X_REQUEST_TIMESTAMP\", signature);\r"," }\r","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"bcb500c0-f509-477d-a826-e19704708349","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{X_REQUEST_SIGNATURE}}","type":"text"},{"key":"X-Request-Timestamp","value":"{{X_REQUEST_TIMESTAMP}}","type":"text"},{"key":"X-Request-publicKey","value":"{{X_REQUEST_PUBLIC_KEY}}","type":"text"}],"url":"{{url}}/payin/v1/countries/:country/routes/:routeId/channels","description":"

Gets the channels by country and route id.

Response Ok

Channels array:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
channelReference	String	Channel reference by country and route id.
channelDescription	String	Channel description.

Responses Error

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Response
404	{\"type\":\"GetChannelByCountryAndRouteIdNotExistError\"}
401	{\"type\": \"ValidationMerchantInvalidTimestampError\"}
401	{\"type\": \"ValidationMerchantCredentialsDoesntMatchError\"}
401	{\"type\":\"ValidationMerchantUnauthorizedError\"}
500	{\"message\":\"An unexpected error occurred.\"}

EndFragment

\n","urlObject":{"path":["payin","v1","countries",":country","routes",":routeId","channels"],"host":["{{url}}"],"query":[],"variable":[{"type":"any","value":"","key":"country"},{"type":"any","value":"","key":"routeId"}]}},"response":[{"id":"34f8d5c2-c2ff-44e2-9016-4107805486b1","name":"200 Ok","originalRequest":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{signature}}"},{"key":"X-Request-Timestamp","value":"{{timestamp}}"},{"key":"X-Request-publicKey","value":"{{publicKey}}"}],"url":{"raw":"{{api}}/payin/v1/countries/:country/routes/:routeId/channels","host":["{{api}}"],"path":["payin","v1","countries",":country","routes",":routeId","channels"],"variable":[{"key":"country","value":""},{"key":"routeId","value":""}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"data\": [\r\n {\r\n \"channelReference\": \"REF 2\",\r\n \"channelDescription\": \"Pago por tarjeta\"\r\n }\r\n ]\r\n}"},{"id":"47b79504-ff27-411b-9033-df60a63e6d87","name":"404 Error","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"","description":"Signature Request"},{"key":"X-Request-Timestamp","value":"","description":"Timestamp"},{"key":"X-Request-publicKey","value":"","description":"B2B Public Key"}],"body":{"mode":"raw","raw":"{\n \"receivingCurrency\": \"USD\",\n \"sendingAmount\": 500,\n \"sendingCountry\": \"PER\",\n \"sendingCurrency\": \"PEN\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/orders/v1/quote"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 16 Feb 2024 22:50:21 GMT"},{"key":"X-Request-Id","value":"69ac09e8-a303-487d-9fd4-05a5d771a933"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"MoleculerError\",\n \"message\": \"There is no merchant associated with the public key.\",\n \"code\": 404,\n \"type\": \"ValidationMerchantPublicKeyNotExistError\"\n}"}],"_postman_id":"bcb500c0-f509-477d-a826-e19704708349"},{"name":"Get details by channel reference","event":[{"listen":"prerequest","script":{"id":"c983e382-4b9d-45c0-96e9-e5ec847606ce","exec":["var requestDetails = {\r"," url: pm.environment.get(\"url\") + \"/merchants/v1/sign\",\r"," method: 'POST',\r"," header: 'Content-Type:application/json',\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," secretKey: pm.environment.get(\"secretKey\"),\r"," privateKey: pm.environment.get(\"certPrivateKey\"),\r"," queryString: {},\r"," body: JSON.parse(pm.variables.replaceIn(pm.request.body.raw))\r"," })\r"," }\r","};\r","\r","pm.sendRequest(requestDetails, function (err, response) {\r"," if (err) {\r"," console.log(err);\r"," } else {\r"," var responseData = response.json();\r"," console.log(responseData);\r"," var timestamp = responseData.timestamp;\r"," var signature = responseData.signature;\r","\r"," pm.environment.set(\"X_REQUEST_SIGNATURE\", timestamp);\r"," pm.environment.set(\"X_REQUEST_TIMESTAMP\", signature);\r"," }\r","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"2311fc0f-101a-42db-9966-83c465fff835","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{X_REQUEST_SIGNATURE}}","type":"text"},{"key":"X-Request-Timestamp","value":"{{X_REQUEST_TIMESTAMP}}","type":"text"},{"key":"X-Request-publicKey","value":"{{X_REQUEST_PUBLIC_KEY}}","type":"text"}],"url":"{{url}}/payin/v1/channels/:channelReference/input","description":"

Gets the detailts by channel reference.

Response Ok

Channels array:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
channelInput	Object	Information necessary to make the payment.
channelExpirationDefault	Number	Time the user has to make the payment.

Responses Error

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Response
404	{\"type\":\"GetChannelByCountryAndRouteIdNotExistError\"}
401	{\"type\": \"ValidationMerchantInvalidTimestampError\"}
401	{\"type\": \"ValidationMerchantCredentialsDoesntMatchError\"}
401	{\"type\":\"ValidationMerchantUnauthorizedError\"}
500	{\"message\":\"An unexpected error occurred.\"}

EndFragment

\n","urlObject":{"path":["payin","v1","channels",":channelReference","input"],"host":["{{url}}"],"query":[],"variable":[{"type":"any","value":"","key":"channelReference"}]}},"response":[{"id":"d68a6614-3726-4452-9e0b-2cc5e52107b7","name":"200 Ok","originalRequest":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{signature}}"},{"key":"X-Request-Timestamp","value":"{{timestamp}}"},{"key":"X-Request-publicKey","value":"{{publicKey}}"}],"url":{"raw":"{{api}}/payin/v1/channels/:channelReference/input","host":["{{api}}"],"path":["payin","v1","channels",":channelReference","input"],"variable":[{"key":"channelReference","value":""}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"channelInput\": {\r\n \"payinAmount\": \"[Decimal] The amount of the transaction\",\r\n \"payinCurrency\": \"[String] The currency of the transaction ISO-4217\",\r\n \"payinProductID\": \"[String] Can be \\\"0\\\"\",\r\n \"payinProductSku\": \"[String] Can be \\\"0\\\"\",\r\n \"payinCustomerCity\": \"[String]\",\r\n \"payinCustomerName\": \"[String] Customer Name\",\r\n \"payinCustomerEmail\": \"[String] Contains the customers email\",\r\n \"payinCustomerPhone\": \"[String]\",\r\n \"payinProductAmount\": \"[String] Can be \\\"0\\\"\",\r\n \"payinCustomerRegion\": \"[String]\",\r\n \"payinExpirationTime\": \"[Integer] Time in minutes to expire\",\r\n \"payinCustomerAddress\": \"[String]\",\r\n \"payinCustomerCountry\": \"[String]\",\r\n \"payinCustomerZipCode\": \"[String]\",\r\n \"payinProductQuantity\": \"[String] Can be \\\"0\\\"\",\r\n \"payinCustomerDocument\": \"[String]\",\r\n \"payinCustomerLastName\": \"[String]\",\r\n \"payinProductDescription\": \"[String] Can be \\\"0\\\"\",\r\n \"payinCustomerShippingCity\": \"[String]\",\r\n \"payinCustomerShippingName\": \"[String]\",\r\n \"payinCustomerTypeDocument\": \"[String]\",\r\n \"payinCustomerShippingPhone\": \"[String]\",\r\n \"payinCustomerShippingRegion\": \"[String]\",\r\n \"payinCustomerShippingAddress\": \"[String]\",\r\n \"payinCustomerShippingCountry\": \"[String]\",\r\n \"payinCustomerShippingZipCode\": \"[String]\"\r\n },\r\n \"channelExpirationDefault\": 30\r\n }\r\n}"},{"id":"800efb3d-f76b-4c81-8a57-be108ccfc659","name":"404 Error","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"","description":"Signature Request"},{"key":"X-Request-Timestamp","value":"","description":"Timestamp"},{"key":"X-Request-publicKey","value":"","description":"B2B Public Key"}],"body":{"mode":"raw","raw":"{\n \"receivingCurrency\": \"USD\",\n \"sendingAmount\": 500,\n \"sendingCountry\": \"PER\",\n \"sendingCurrency\": \"PEN\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/orders/v1/quote"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 16 Feb 2024 22:50:21 GMT"},{"key":"X-Request-Id","value":"69ac09e8-a303-487d-9fd4-05a5d771a933"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"MoleculerError\",\n \"message\": \"There is no merchant associated with the public key.\",\n \"code\": 404,\n \"type\": \"ValidationMerchantPublicKeyNotExistError\"\n}"}],"_postman_id":"2311fc0f-101a-42db-9966-83c465fff835"},{"name":"Create payin with checkout","event":[{"listen":"prerequest","script":{"id":"2ae2a86b-8c38-455e-935d-2de0564ced52","exec":["var requestDetails = {\r"," url: pm.environment.get(\"url\") + \"/merchants/v1/sign\",\r"," method: 'POST',\r"," header: 'Content-Type:application/json',\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," secretKey: pm.environment.get(\"secretKey\"),\r"," privateKey: pm.environment.get(\"certPrivateKey\"),\r"," queryString: {},\r"," body: JSON.parse(pm.variables.replaceIn(pm.request.body.raw))\r"," })\r"," }\r","};\r","\r","pm.sendRequest(requestDetails, function (err, response) {\r"," if (err) {\r"," console.log(err);\r"," } else {\r"," var responseData = response.json();\r"," console.log(responseData);\r"," var timestamp = responseData.timestamp;\r"," var signature = responseData.signature;\r","\r"," pm.environment.set(\"X_REQUEST_SIGNATURE\", timestamp);\r"," pm.environment.set(\"X_REQUEST_TIMESTAMP\", signature);\r"," }\r","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"d3c532a4-0f7d-43a4-8eb6-cda3a7620af5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Request-Signature","value":"{{X_REQUEST_SIGNATURE}}","type":"text"},{"key":"X-Request-Timestamp","value":"{{X_REQUEST_TIMESTAMP}}","type":"text"},{"key":"X-Request-publicKey","value":"{{X_REQUEST_PUBLIC_KEY}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"userData\": {\r\n \"firstName\": \"Gian\",\r\n \"middleName\": \"Luca\",\r\n \"lastName\": \"Lapa\",\r\n \"secondLastName\": \"Dula\",\r\n \"email\": \"gianluca@test.com\",\r\n \"phone\": \"+59123456789\",\r\n \"documentType\": \"DNI\",\r\n \"documentNumber\": \"12345678\",\r\n \"address\": \"address\",\r\n \"city\": \"Lima\",\r\n \"region\": \"Callao\",\r\n \"zipCode\": \"00051\"\r\n },\r\n \"currency\": \"PEN\",\r\n \"amount\": 200.55,\r\n \"country\": \"PER\",\r\n \"merchantCurrency\": \"USD\",\r\n \"merchantReference\": \"628\",\r\n \"payinType\": \"PAYMENT_AMOUNT\",\r\n \"timeExpiration\": 30\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/payin/v1/payment","description":"

With this endpoint the B2B client can be create a payin with checkout webview.

Request

Field	Type	Required	Description
userData	Object	true	Object containing customer information
userData.firstName	String	true	Customer’s first name.
userData.middleName	String	true(If you do not send any information, send an empty string)	Customer’s middle name.
userData.lastName	String	true	Customer’s last name.
userData.secondLastName	String	true(If you do not send any information, send an empty string)	Customer’s second last name.
userData.email	String	true	Customer’s email address.
userData.phone	String	true	Customer’s phone number including the country code. Ej. +51923456789
userData.documentType	String	true(If you do not send any information, send an empty string)	Type of identification document of the customer. Values: - DNI: National Identity Document - CE: Foreigner’s Identity Card - PAS: Passport - RUC: Tax Identification Number - SOSE: Social Security or equivalent document - CPF: Individual Taxpayer Registry (Brazil) - CNPJ: National Registry of Legal Entities (Brazil)
userData.documentNumber	String	true(If you do not send any information, send an empty string)	Customer’s identification document number.
userData.address	String	true(If you do not send any information, send an empty string)	Customer’s residential address.
userData.city	String	true(If you do not send any information, send an empty string)	City where the customer resides.
userData.region	String	true(If you do not send any information, send an empty string)	Region, province, or state of the customer’s residence.
userData.zipCode	String	true(If you do not send any information, send an empty string)	Customer’s postal or ZIP code.
currency	String	true	Currency of the transaction (ISO-4217). Ej. PEN, BRL
amount	Number	true	The amount of the transaction. Use 2 decimals
country	String	true	ISO 3166-1 alpha-3 country code. Ej. PER, BRA
merchantReference	String	true	Reference number for each collection. Used to notify merchants about a payment
merchantCurrency	String	false	Currency of the transaction (ISO-4217). Ej: USD. Define the currency in which B89 will deposit the amount to the merchant previously defined by the business. If not sent, use the currency value.
payinType	String	true	Payin information. Values: - PAYMENT_AMOUNT
timeExpiration	Number	false	Time in minutes to expire the URL with the payment code. If the timeExpiration parameter is not provided, the default expiration time configured in the system will be applied. For other countries: - Online: 30 minutes For Brazil: - Online: 2 hours - Cash 24 hrs
gloss	String	false	Payment description or note (maximum 120 characters). Used for generated QR codes.

Response Ok

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
payinId	String	Payment id
merchantReference	String	Code that indicates the payment operation
checkoutUrl	String	Url redirecting to a web view for payment

Responses Error

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Response
404	{\"type\":\"CreatePaymentBadRequestError\"}
401	{\"type\": \"ValidationMerchantInvalidTimestampError\"}
401	{\"type\": \"ValidationMerchantCredentialsDoesntMatchError\"}
401	{\"type\":\"ValidationMerchantUnauthorizedError\"}
500	{\"message\":\"An unexpected error occurred.\"}

EndFragment

\n","urlObject":{"path":["payin","v1","payment"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"b179c3e6-2ea0-4e77-bf05-7c23db0b3462","name":"200 Ok","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"{{signature}}"},{"key":"X-Request-Timestamp","value":"{{timestamp}}"},{"key":"X-Request-publicKey","value":"{{publicKey}}"}],"body":{"mode":"raw","raw":"{\r\n \"userData\": {\r\n \"firstName\": \"Gian\",\r\n \"middleName\": \"Luca\",\r\n \"lastName\": \"Lapa\",\r\n \"secondLastName\": \"Dula\",\r\n \"email\": \"gianluca@test.com\",\r\n \"phone\": \"+51123456789\",\r\n \"documentType\": \"DNI\",\r\n \"documentNumber\": \"12345678\",\r\n \"address\": \"address\",\r\n \"city\": \"Lima\",\r\n \"region\": \"Callao\",\r\n \"zipCode\": \"00051\"\r\n },\r\n \"currency\": \"PEN\",\r\n \"amount\": 200.55,\r\n \"country\": \"PER\",\r\n \"merchantReference\": \"628\",\r\n \"payinType\": \"PAYMENT_AMOUNT\",\r\n \"timeExpiration\": 30\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/payin/v1/payment"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 16 May 2024 19:12:16 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-request-id","value":"3456a88c-d06f-4ea2-980f-e6e2db9cd72d"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=J%2BNCsJSOuYNxbuty4pTaBk6C4jScAp1GyvlJtCxqsxjwnq57annjPL0Kifj4HtWFPyf%2FeJg5kGrIqb0yRiVFCaDyrCttDmlp8TCM2rZ8FE7l3CE9%2BFkcUiHKpII%2FVdtjOqpyxlXCyTe%2B\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"884dada4ab9c081d-IAD"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"payinId\": \"355c577f-13b8-11ef-9ff9-0242ac120022\",\n \"merchantReference\": \"628\",\n \"checkoutUrl\": \"https://uat-checkout.b89.io/payin/355c577f-13b8-11ef-9ff9-0242ac120022?T=1715886736000\"\n }\n}"},{"id":"4c1336a0-81f0-4177-8e4f-89739bd3fc82","name":"404 Error","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"","description":"Signature Request"},{"key":"X-Request-Timestamp","value":"","description":"Timestamp"},{"key":"X-Request-publicKey","value":"","description":"B2B Public Key"}],"body":{"mode":"raw","raw":"{\n \"userData\": {\n \"firstName\": \"Gian\",\n \"middleName\": \"Luca\",\n \"lastName\": \"Lapa\",\n \"secondLastName\": \"Dula\",\n \"email\": \"gianluca@test.com\",\n \"phone\": \"+51123456789\",\n \"documentType\": \"DNI\",\n \"documentNumber\": \"12345678\",\n \"address\": \"address\",\n \"city\": \"Lima\",\n \"region\": \"Callao\"\n },\n \"currency\": \"PEN\",\n \"amount\": 200.55,\n \"country\": \"PER\",\n \"merchantReference\": \"628\",\n \"payinType\": \"PAYMENT_AMOUNT\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/payin/v1/payment"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 16 Feb 2024 22:50:21 GMT"},{"key":"X-Request-Id","value":"69ac09e8-a303-487d-9fd4-05a5d771a933"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"MoleculerError\",\n \"message\": \"There is no merchant associated with the public key.\",\n \"code\": 404,\n \"type\": \"ValidationMerchantPublicKeyNotExistError\"\n}"}],"_postman_id":"d3c532a4-0f7d-43a4-8eb6-cda3a7620af5"},{"name":"Create payin without checkout","event":[{"listen":"prerequest","script":{"id":"4b8315c7-b632-405e-9540-e15186f93145","exec":["var requestDetails = {\r"," url: pm.environment.get(\"url\") + \"/merchants/v1/sign\",\r"," method: 'POST',\r"," header: 'Content-Type:application/json',\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," secretKey: pm.environment.get(\"secretKey\"),\r"," privateKey: pm.environment.get(\"certPrivateKey\"),\r"," queryString: {},\r"," body: JSON.parse(pm.variables.replaceIn(pm.request.body.raw))\r"," })\r"," }\r","};\r","\r","pm.sendRequest(requestDetails, function (err, response) {\r"," if (err) {\r"," console.log(err);\r"," } else {\r"," var responseData = response.json();\r"," console.log(responseData);\r"," var timestamp = responseData.timestamp;\r"," var signature = responseData.signature;\r","\r"," pm.environment.set(\"X_REQUEST_SIGNATURE\", timestamp);\r"," pm.environment.set(\"X_REQUEST_TIMESTAMP\", signature);\r"," }\r","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"b12f3fe7-c32e-41b2-809e-39d7ba9a0072","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Request-Signature","value":"{{X_REQUEST_SIGNATURE}}"},{"key":"X-Request-Timestamp","value":"{{X_REQUEST_TIMESTAMP}}"},{"key":"X-Request-publicKey","value":"{{X_REQUEST_PUBLIC_KEY}}"}],"body":{"mode":"raw","raw":"{\r\n \"userData\": {\r\n \"firstName\": \"Gian\",\r\n \"middleName\": \"Luca\",\r\n \"lastName\": \"Lapa\",\r\n \"secondLastName\": \"Dula\",\r\n \"email\": \"gianluca@test.com\",\r\n \"phone\": \"+51923456789\",\r\n \"documentType\": \"DNI\",\r\n \"documentNumber\": \"12345678\",\r\n \"address\": \"address\",\r\n \"city\": \"Lima\",\r\n \"region\": \"Callao\",\r\n \"zipCode\": \"00051\"\r\n },\r\n \"amount\": 500,\r\n \"currency\": \"PEN\",\r\n \"country\": \"PER\",\r\n \"merchantCurrency\": \"PEN\",\r\n \"merchantReference\": \"B890148\",\r\n \"payinType\": \"PAYMENT_AMOUNT\",\r\n \"requestType\": \"API\",\r\n \"channelReference\": \"QR_PAY_MG\",\r\n \"gloss\": \"Esta es una glosa\",\r\n \"timeExpiration\": 30\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/payin/v1/payment","description":"

With this endpoint, the B2B customer can create a checkout-free payment, allowing them to generate payments via a QR code or bank transfer.

Request

Field	Type	Required	Description
userData	Object	true	Object containing customer information
userData.firstName	String	true	Customer’s first name.
userData.middleName	String	true(If you do not send any information, send an empty string)	Customer’s middle name.
userData.lastName	String	true	Customer’s last name.
userData.secondLastName	String	true(If you do not send any information, send an empty string)	Customer’s second last name.
userData.email	String	true	Customer’s email address.
userData.phone	String	true	Customer’s phone number including the country code. Ej. +51923456789
userData.documentType	String	true(If you do not send any information, send an empty string)	Type of identification document of the customer. Values: - DNI: National Identity Document - CE: Foreigner’s Identity Card - PAS: Passport - RUC: Tax Identification Number - SOSE: Social Security or equivalent document - CPF: Individual Taxpayer Registry (Brazil) - CNPJ: National Registry of Legal Entities (Brazil)
userData.documentNumber	String	true(If you do not send any information, send an empty string)	Customer’s identification document number.
userData.address	String	true(If you do not send any information, send an empty string)	Customer’s residential address.
userData.city	String	true(If you do not send any information, send an empty string)	City where the customer resides.
userData.region	String	true(If you do not send any information, send an empty string)	Region, province, or state of the customer’s residence.
userData.zipCode	String	true(If you do not send any information, send an empty string)	Customer’s postal or ZIP code.
currency	String	true	Currency of the transaction (ISO-4217). Ej. PEN, BRL
amount	Number	true	The amount of the transaction. Use 2 decimals
country	String	true	ISO 3166-1 alpha-3 country code. Ej. PER, BRA
merchantReference	String	true	Reference number for each collection. Used to notify merchants about a payment
merchantCurrency	String	false	Currency of the transaction (ISO-4217). Ej: USD. Define the currency in which B89 will deposit the amount to the merchant previously defined by the business. If not sent, use the currency value.
payinType	String	true	Payin information. Values: - PAYMENT_AMOUNT
timeExpiration	Number	false	Time in minutes to expire the URL with the payment code. If the timeExpiration parameter is not provided, the default expiration time configured in the system will be applied. For other countries: - Online: 30 minutes For Brazil: - Online: 2 hours - Cash 24 hrs
gloss	String	false	Payment description or note (maximum 120 characters). Used for generated QR codes.
requestType	String	false	Flow type: API (without checkout) or CHECKOUT (with checkout). If not sent, use flow with checkout.
channelReference	String	Conditional	Payment channel reference (Ej: QR_PAY_MG, BANK_TRANSFER_MANUAL, BANK_TRANSFER_MANUAL_USD). Required if requestType is API.

Response Ok

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
payinId	String	Payment id
merchantReference	String	Code that indicates the payment operation
checkoutUrl	String	Url redirecting to a web view for payment
payinInfo	Object	Additional payment method information. The values returned in each field vary depending on the channelReference used.
payinInfo.qrUrl	String	URL to redirect to a web view where payment can be made
payinInfo.qrImage	String	Base64 encoded QR image that can be rendered directly
payinInfo.expirationTime	Number or null	Expiration timestamp in milliseconds
payinInfo.cciVirtual	String	Virtual CCI for bank transfers
payinInfo.swift	String	SWIFT code for international transfers
payinInfo.bankName	String	Name of the receiving bank

Responses Error

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Response
404	{\"type\":\"CreatePaymentBadRequestError\"}
401	{\"type\": \"ValidationMerchantInvalidTimestampError\"}
401	{\"type\": \"ValidationMerchantCredentialsDoesntMatchError\"}
401	{\"type\":\"ValidationMerchantUnauthorizedError\"}
500	{\"message\":\"An unexpected error occurred.\"}

EndFragment

\n","urlObject":{"path":["payin","v1","payment"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"e4f645ed-b6fc-48bf-b8d1-9e5ddbf7d49c","name":"200 Ok","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"{{signature}}"},{"key":"X-Request-Timestamp","value":"{{timestamp}}"},{"key":"X-Request-publicKey","value":"7692742d-f4ab-4b18-9f96-36fbb2c3ed63"}],"body":{"mode":"raw","raw":"{\r\n \"userData\": {\r\n \"firstName\": \"Gian\",\r\n \"middleName\": \"Luca\",\r\n \"lastName\": \"Lapa\",\r\n \"secondLastName\": \"Dula\",\r\n \"email\": \"gianluca@test.com\",\r\n \"phone\": \"+51923456789\",\r\n \"documentType\": \"DNI\",\r\n \"documentNumber\": \"12345678\",\r\n \"address\": \"address\",\r\n \"city\": \"Lima\",\r\n \"region\": \"Callao\",\r\n \"zipCode\": \"00051\"\r\n },\r\n \"amount\": 500,\r\n \"currency\": \"PEN\",\r\n \"country\": \"PER\",\r\n \"merchantCurrency\": \"PEN\",\r\n \"merchantReference\": \"MERCHANT_CODE_000001\",\r\n \"payinType\": \"PAYMENT_AMOUNT\",\r\n \"requestType\": \"API\",\r\n \"channelReference\": \"QR_PAY_MG\",\r\n \"gloss\": \"Esta es una glosa\",\r\n \"timeExpiration\": 30\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/payin/v1/payment"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 16 May 2024 19:12:16 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-request-id","value":"3456a88c-d06f-4ea2-980f-e6e2db9cd72d"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=J%2BNCsJSOuYNxbuty4pTaBk6C4jScAp1GyvlJtCxqsxjwnq57annjPL0Kifj4HtWFPyf%2FeJg5kGrIqb0yRiVFCaDyrCttDmlp8TCM2rZ8FE7l3CE9%2BFkcUiHKpII%2FVdtjOqpyxlXCyTe%2B\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"884dada4ab9c081d-IAD"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"payinId\": \"ef2544af-3a6e-11f0-beee-0242ac120002\",\n \"merchantReference\": \"MERCHANT_CODE_000001\",\n \"checkoutUrl\": \"\",\n \"payinInfo\": {\n \"qrUrl\": \"https://ecommerce.b89.io/tokenizesandbox/Home?tkpix=Y1NPWmgvTDh3b3N1a0N6b3dpSWJYTHN4THd1N09GMVBHTWhlN1pVNHBNVT0=\",\n \"qrImage\": \"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\",\n \"expirationTime\": 1770393164371,\n \"cciVirtual\": \"00212345678901234567\",\n \"swift\": \"BCPLPEPL\",\n \"bankName\": \"BCP\"\n\n }\n }\n}"},{"id":"d8a45faa-e6cd-4734-8bed-89c98ac67ac3","name":"404 Error","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"","description":"Signature Request"},{"key":"X-Request-Timestamp","value":"","description":"Timestamp"},{"key":"X-Request-publicKey","value":"","description":"B2B Public Key"}],"body":{"mode":"raw","raw":"{\n \"userData\": {\n \"firstName\": \"Gian\",\n \"middleName\": \"Luca\",\n \"lastName\": \"Lapa\",\n \"secondLastName\": \"Dula\",\n \"email\": \"gianluca@test.com\",\n \"phone\": \"+51923456789\",\n \"documentType\": \"DNI\",\n \"documentNumber\": \"12345678\",\n \"address\": \"address\",\n \"city\": \"Lima\",\n \"region\": \"Callao\",\n \"zipCode\": \"00051\"\n },\n \"amount\": 500,\n \"currency\": \"PEN\",\n \"country\": \"PER\",\n \"merchantCurrency\": \"PEN\",\n \"merchantReference\": \"MERCHANT_CODE_000001\",\n \"payinType\": \"PAYMENT_AMOUNT\",\n \"requestType\": \"API\",\n \"channelReference\": \"QR_PAY_MG\",\n \"gloss\": \"Esta es una glosa\",\n \"timeExpiration\": 30\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/payin/v1/payment"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 16 Feb 2024 22:50:21 GMT"},{"key":"X-Request-Id","value":"69ac09e8-a303-487d-9fd4-05a5d771a933"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"MoleculerError\",\n \"message\": \"There is no merchant associated with the public key.\",\n \"code\": 404,\n \"type\": \"ValidationMerchantPublicKeyNotExistError\"\n}"}],"_postman_id":"b12f3fe7-c32e-41b2-809e-39d7ba9a0072"},{"name":"Payment notification","id":"2a4313ea-9b2a-4f6f-9748-145f1e53a03b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"merchantReference\": \"628\",\r\n \"channelReference\": \"BANK_TRANSFER_ALFA\",\r\n \"payinState\": \"CONFIRMED\",\r\n \"payinAmount\": 250.55,\r\n \"payinCurrency\": \"PEN\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url_payment_notification}}","description":"

When B89 receives a notification of a processed transaction (payment approved, denied, or expired), B89 will notify the merchant's POST URL.

To do this, the merchant must provide B89 with a public URL (HTTPS) of POST type. The service behind the shared URL can be coded in any programming language, but must respond using a standard format (REST API).

\n
Note:
url_payment_notification: It is the url that the dealer shares with b89 to configure our environment and send notifications of processed transactions.
\n

B89 WILL PUBLISH the following information at the URL:

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
merchantReference	String	Reference number for each collection. Used to notify merchants about a payment
channelReference	String	Reference channel choosen by the merchant to make the payment
payinState	String	Payin Status description. Examples: PENDING, EXPIRED, CONFIRMED, DENIED
payinAmount	Number	The amount of the transaction. Uses 1 decimal. (decimal value)
payinCurrency	String	The currency of the transaction (ISO-4217). Example: PER, EUR, USD, etc.

Response:
B89 expects a 200 error response to confirm delivery of the notification.

\n","urlObject":{"host":["{{url_payment_notification}}"],"query":[],"variable":[]}},"response":[{"id":"98e7e5d4-5516-47a7-b5a2-ef275a7fca5d","name":"200 OK","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"merchantReference\": \"628\",\r\n \"channelReference\": \"BANK_TRANSFER_ALFA\",\r\n \"payinState\": \"CONFIRMED\",\r\n \"payinAmount\": 250.55,\r\n \"payinCurrency\": \"PEN\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url_payment_notification}}"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"2a4313ea-9b2a-4f6f-9748-145f1e53a03b"}],"id":"c7bc67bb-c2fb-40b7-a890-58ea03deee8c","description":" $\"API%20Sequence\"$ ","_postman_id":"c7bc67bb-c2fb-40b7-a890-58ea03deee8c"},{"name":"Compliance","item":[{"name":"create client consult","event":[{"listen":"prerequest","script":{"id":"c15b0dba-db85-4d8f-8d12-f8aa349920ec","exec":["const requestDetails = {\r"," url: \"{{url}}/merchants/v1/sign\",\r"," method: 'POST',\r"," header: 'Content-Type:application/json',\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," \"documentType\": 1,\r"," \"documentNumber\": \"78941023\",\r"," \"documentCountry\": \"PER\",\r"," \"consultType\": \"DOCUMENT_ONLY\",\r"," \"metadata\": {\r"," \"firstName\": \"JUAN\",\r"," \"lastName\": \"MORALES\"\r"," },\r"," \"webhook\": {\r"," \"endpoint\": \"\"\r"," },\r"," \"reference\": \"\"\r"," })\r"," }\r","};\r","\r","pm.sendRequest(requestDetails, function (err, response) {\r"," if (err) {\r"," console.log(err);\r"," } else {\r"," const responseData = response.json();\r"," console.log(responseData);\r"," const timestamp = responseData.timestamp;\r"," const signature = responseData.signature;\r","\r"," pm.environment.set(\"signature\", signature);\r"," pm.environment.set(\"timestamp\", timestamp);\r"," }\r","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"a83d568f-82ca-4588-a621-e37c6d8550df","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Request-Signature","value":"{{signature}}"},{"key":"X-Request-Timestamp","value":"{{timestamp}}"},{"key":"X-Request-publicKey","value":""}],"body":{"mode":"raw","raw":"{\r\n \"documentType\": 1,\r\n \"documentNumber\": \"78941023\",\r\n \"documentCountry\": \"PER\",\r\n \"consultType\": \"DOCUMENT_ONLY\",\r\n \"metadata\": {\r\n \"firstName\": \"JUAN\",\r\n \"lastName\": \"MORALES\"\r\n },\r\n \"webhook\": {\r\n \"endpoint\": \"\"\r\n },\r\n \"reference\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/compliance/v1/client/consult","description":"

This endpoint facilitates merchants to register a customer.

Name	Type	Required	Description
documentNumber	string	true	Document number of the individual.
documentType	string	true	Type of document provided. Valid values are 1, 2, 3, 4 and 111.
documentExtension	string	false	Extension for Bolivian identity documents, should only be sent when documentType is 111.
firstName	string	true	Person's firstname
middleName	string	false	Perso'n middlename
lastName	string	true	Person's first lastname
secondLastName	string	false	Person's second lastname
birthdate	string	true	Date of birth of the person
residenceCountry	string	true	Country of residence
birthCountry	string	true	Country of birth
nationality	string	true	Nationality of the individual
gender	string	false	Gender of the individual. Valid values are 'M' (Male), 'F' (Female), and 'O' (Other).
maritalStatus	string	false	Person's marital status. Valid values are 'S' (Single), 'C' (Married), 'V' (Widowed), and 'D' (Divorced).
phoneNumber	string	false	Person's phone number
emailAddress	string	false	Email address of the person
addressLine	string	false	Person's address

","urlObject":{"path":["compliance","v1","client","consult"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"26d7baf7-4178-4e59-b9da-8693f7328106","name":"create client consult - 200","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"{{signature}}"},{"key":"X-Request-Timestamp","value":"{{timestamp}}"},{"key":"X-Request-publicKey","value":""}],"body":{"mode":"raw","raw":"{\r\n \"documentType\": 1,\r\n \"documentNumber\": \"78941023\",\r\n \"documentCountry\": \"PER\",\r\n \"consultType\": \"DOCUMENT_ONLY\",\r\n \"metadata\": {\r\n \"firstName\": \"JUAN\",\r\n \"lastName\": \"MORALES\"\r\n },\r\n \"webhook\": {\r\n \"endpoint\": \"\"\r\n },\r\n \"reference\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/tpa/v1/person"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\r\n \"consultId\": \"7b8fcb87-c004-11f0-9933-0242ac120002\",\r\n \"documentNumber\": \"78941023\",\r\n \"documentType\": 1,\r\n \"createdAt\": \"2025-11-12T15:16:33.000Z\",\r\n \"status\": \"PENDING\"\r\n}"},{"id":"b13e8ab7-bc9a-4af2-8337-02902a5c3c6e","name":"create client consult - 200 Existing Consult","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"{{signature}}"},{"key":"X-Request-Timestamp","value":"{{timestamp}}"},{"key":"X-Request-publicKey","value":""}],"body":{"mode":"raw","raw":"{\r\n \"documentType\": 1,\r\n \"documentNumber\": \"78941023\",\r\n \"documentCountry\": \"PER\",\r\n \"consultType\": \"DOCUMENT_ONLY\",\r\n \"metadata\": {\r\n \"firstName\": \"JUAN\",\r\n \"lastName\": \"MORALES\"\r\n },\r\n \"webhook\": {\r\n \"endpoint\": \"\"\r\n },\r\n \"reference\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/compliance/v1/client/consult"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"510f98d0-bfee-11f0-a264-0242ac12001b\",\r\n \"documentType\": 1,\r\n \"documentNumber\": \"78941023\",\r\n \"firstName\": \"JUAN\",\r\n \"middleName\": null,\r\n \"lastName\": \"MORALES\",\r\n \"secondLastName\": null,\r\n \"webhook\": {\r\n \"endpoint\": \"https://2a13b4454d11.ngrok-free.app/webhook\"\r\n },\r\n \"merchantId\": \"cb46d9e2-d176-4bb7-9fd7-bd10b7e1afea\",\r\n \"pep\": false,\r\n \"risk\": false,\r\n \"warning\": false,\r\n \"riskDescription\": null,\r\n \"status\": \"B2B_CONSULT_COMPLETED\",\r\n \"createdDatetime\": \"2025-11-12T12:37:53.000Z\",\r\n \"expirationDatetime\": \"2026-01-12T12:37:53.000Z\"\r\n}"},{"id":"e9192dfa-18bf-4241-850f-e6150d1237b8","name":"create client consult - 400 Bad Request","originalRequest":{"method":"POST","header":[{"key":"X-Request-Signature","value":"{{signature}}"},{"key":"X-Request-Timestamp","value":"{{timestamp}}"},{"key":"X-Request-publicKey","value":""}],"body":{"mode":"raw","raw":"{\r\n \"documentType\": \"DNI\",\r\n \"documentNumber\": \"78941023\",\r\n \"documentCountry\": \"PER\",\r\n \"consultType\": \"DOCUMENT_ONLY\",\r\n \"metadata\": {\r\n \"firstName\": \"JUAN\",\r\n \"lastName\": \"MORALES\"\r\n },\r\n \"webhook\": {\r\n \"endpoint\": \"\"\r\n },\r\n \"reference\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/compliance/v1/client/consult"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"MoleculerError\",\n \"message\": \"\\\"documentType\\\" must be one of [1, 2, 3, 4]. \\\"documentType\\\" must be a number\",\n \"code\": 400,\n \"type\": \"GenerateClientConsultBadRequestError\"\n}"}],"_postman_id":"a83d568f-82ca-4588-a621-e37c6d8550df"},{"name":"get consult","event":[{"listen":"prerequest","script":{"id":"e95be47f-eca5-4bd5-ac4d-3561357e7399","exec":["const requestDetails = {\r"," url: \"{{url}}/merchants/v1/sign\",\r"," method: 'POST',\r"," header: 'Content-Type:application/json',\r"," body: {\r"," mode: 'raw',\r"," raw: JSON.stringify({\r"," secretKey: \"\",\r"," privateKey: \"\",\r"," queryString: {\r"," id: \"35a8bf98-70e0-42f1-b3f5-acd9d861764f\"\r"," },\r"," body: {}\r"," })\r"," }\r","};\r","\r","pm.sendRequest(requestDetails, function (err, response) {\r"," if (err) {\r"," console.log(err);\r"," } else {\r"," const responseData = response.json();\r"," console.log(responseData);\r"," const timestamp = responseData.timestamp;\r"," const signature = responseData.signature;\r","\r"," pm.environment.set(\"signature\", signature);\r"," pm.environment.set(\"timestamp\", timestamp);\r"," }\r","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"c1d65e66-b6d3-4249-bb05-f5152fd557e6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{signature}}"},{"key":"X-Request-Timestamp","value":"{{timestamp}}"},{"key":"X-Request-publicKey","value":""}],"url":"{{url}}/compliance/v1/consult/:id","description":"

This endpoint retrieves the information of virtual cards for merchants.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
id	param	true	Unique Identifier of the virtual card

","urlObject":{"path":["compliance","v1","consult",":id"],"host":["{{url}}"],"query":[],"variable":[{"id":"b9dd7e8a-6762-41bc-9fd1-e7972ae0c5bd","type":"any","value":"35a8bf98-70e0-42f1-b3f5-acd9d861764f","key":"id"}]}},"response":[{"id":"2ccf6d41-4be5-4bfc-a48a-eeeb671f9b61","name":"get consult - 200","originalRequest":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{signature}}"},{"key":"X-Request-Timestamp","value":"{{timestamp}}"},{"key":"X-Request-publicKey","value":""}],"url":{"raw":"{{url}}/tpa/v1/card/:id/details","host":["{{url}}"],"path":["tpa","v1","card",":id","details"],"variable":[{"key":"id","value":"33233694-bfe5-11f0-9933-0242ac120002"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"33233694-bfe5-11f0-9933-0242ac120002\",\n \"documentType\": 1,\n \"documentNumber\": \"78941023\",\n \"firstName\": \"JUAN\",\n \"middleName\": null,\n \"lastName\": \"MORALES\",\n \"secondLastName\": null,\n \"webhook\": {\n \"authType\": \"none\",\n \"endpoint\": \"https://66096938814d.ngrok-free.app/webhook\"\n },\n \"merchantId\": \"369309e9-fbf4-4c47-a40b-60f5a3a636bc\",\n \"pep\": null,\n \"risk\": null,\n \"warning\": null,\n \"riskDescription\": null,\n \"status\": \"PENDING\",\n \"createdDatetime\": \"2025-11-12T11:32:37.000Z\",\n \"expirationDatetime\": \"2026-01-12T11:32:37.000Z\"\n}"},{"id":"57cab041-12be-430a-bc11-cc24366ae21f","name":"get consult - 404 Not Found","originalRequest":{"method":"GET","header":[{"key":"X-Request-Signature","value":"{{signature}}"},{"key":"X-Request-Timestamp","value":"{{timestamp}}"},{"key":"X-Request-publicKey","value":""}],"url":{"raw":"{{url}}/tpa/v1/card/:id/details","host":["{{url}}"],"path":["tpa","v1","card",":id","details"],"variable":[{"key":"id","value":"35a8bf98-70e0-42f1-b3f5-acd9d861764f"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"MoleculerError\",\n \"message\": \"Compliance consult not found\",\n \"code\": 404,\n \"type\": \"GetComplianceConsultNotFoundError\"\n}"}],"_postman_id":"c1d65e66-b6d3-4249-bb05-f5152fd557e6"}],"id":"0f21cc27-e754-452f-a860-2e305c49bf50","description":"

This service provides a comprehensive set of APIs that enable B89 partners and merchants to perform compliance checks for their end customers. The service enables partners to seamlessly integrate compliance verification operations into their systems, offering flexible and secure solutions for customer due diligence and risk assessment. It aims to improve the efficiency and effectiveness of compliance processes, ensuring that partners can maintain secure and compliant onboarding and monitoring experiences for their businesses.

Status Codes

All status codes are standard HTTP status codes. The below ones are used in this API.

2XX - Success of some kind

4XX - Error occurred in client’s part

5XX - Error occurred in server’s part

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status Code	Description
200	OK
201	Created
202	Accepted (Request accepted, and queued for execution)
400	Bad Request
401	Authentication Failure
403	Forbidden
404	Resource Not Found
405	Method Not Allowed
409	Conflict
412	Precondition Failed
413	Request Entity Too Large
500	Internal Server Error
501	Not Implemented
503	Service Unavailable

","_postman_id":"0f21cc27-e754-452f-a860-2e305c49bf50"}],"event":[{"listen":"prerequest","script":{"id":"f72c90d3-9806-470a-ae52-52978e3e3dd9","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"83bcf153-7907-4667-930a-82394c473290","type":"text/javascript","exec":[""]}}]}