Botón de Pago
- x-api-keystringrequiredDescription
- x-access-tokenstringrequiredDescription
- content-typestringrequiredDescription
- totalNumberrequiredDescription
- descriptionstringrequiredDescription
- currencystringrequiredDescription
- referencestringrequiredDescription
- testBooleanDescription
- return_urlstringDescription
- webhookstringDescription
- itemsArrayDescription
- optionsObjectDescription
- themeBooleanDescription
- emitNotificationsBooleanDescription
- emitCustomerSuccessNotificationBooleanDescription
- emitCustomerFailureNotificationBooleanDescription
- emitCustomerWaitingNotificationBooleanDescription
- closeOrReturnOnResultBooleanDescription
- closeOrReturnTimeoutIntegerDescription
- sourcesArrayDescription
- installmentsArrayDescription
- customerObjectrequiredDescription
- emailstringrequiredDescription
- namestringrequiredDescription
- identificationstringrequiredDescription
- phonestringDescription
- uidstringDescription
- {metadata}ObjectDescription
- createdAtintegerDescription
- birthdateobjectDescription
- dayintegerrequiredDescription
- monthintegerrequiredDescription
- yearintegerrequiredDescription
- splitArrayDescription
- timeoutNumberDescription
- intentstringDescription
- multicardBooleanDescription
- addressesArrayDescription
- addresses[$].typestringDescription
- addresses[$].countrystringDescription
- addresses[$].streetstringDescription
- addresses[$].streetNumberstringDescription
- addresses[$].streetNotesstringDescription
- addresses[$].zipCodestringDescription
- addresses[$].citystringDescription
- addresses[$].statestringDescription
- webhooksTypeStringDescription
- multivendorstringDescription
- merchantsArrayDescription
- merchants.[$].uidstringrequiredDescription
- merchants.[$].intentstringDescription
var client = new RestClient("https://api.unicobros.com.ar/p/checkout");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("x-api-key", "zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj");
request.AddHeader("x-access-token", "d31f0721-2f85-44e7-bcc6-15e19d1a53cc");
request.AddHeader("Content-Type", "application/json");
var body = @"{
" + "\n" +
@" ""total"": ""100.53"",
" + "\n" +
@" ""description"": ""Checkout de Prueba"",
" + "\n" +
@" ""reference"": ""260520210954"",
" + "\n" +
@" ""currency"": ""ARS"",
" + "\n" +
@" ""test"": true,
" + "\n" +
@" ""return_url"": ""https://unicobros.com.ar/return_url"",
" + "\n" +
@" ""webhook"": ""https://unicobros.com.ar/webhook"",
" + "\n" +
@" ""customer"": {
" + "\n" +
@" ""email"": ""[email protected]"",
" + "\n" +
@" ""name"": ""Cliente Demo"",
" + "\n" +
@" ""identification"": ""12123123""
" + "\n" +
@" }
" + "\n" +
@"}";
request.AddParameter("application/json", body, ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);curl --location --request POST 'https://api.unicobros.com.ar/checkout' \
--header 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj' \
--header 'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc' \
--header 'Content-Type: application/json' \
--data-raw '{
"total": "100.53",
"description": "Checkout de Prueba",
"reference": "260520210954",
"currency": "ARS",
"test": true,
"return_url": "https://unicobros.com.ar/return_url",
"webhook": "https://unicobros.com.ar/webhook",
"customer": {
"email": "[email protected]",
"name": "Cliente Demo",
"identification": "12123123"
}
}'import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
HttpClient httpClient = HttpClient.newBuilder().version(HttpClient.Version.HTTP_2).build();
String data = "{\n\t\"total\": 100.2,\n\t\"currency\": \"ars\",\n\t\"reference\": \"2982-2XtPXlgSaWccqUyobuv4sEmLYMV0N6oX6MoridMw\",\n\t\"description\": \"Descripción de la Venta\",\n\t\"return_url\": \"https://mobbex.com/sale/return?session=56789\",\n\t\"webhook\": \"https://mobbex.com/sale/webhook?user=1234\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.POST(HttpRequest.BodyPublishers.ofString(data))
.uri(URI.create("https://api.unicobros.com.ar/p/intent"))
.setHeader("x-api-key", MobbexClient.xApiKey)
.setHeader("x-lang", "es")
.setHeader("x-access-token", MobbexClient.xAccessToken)
.setHeader("Content-Type", "application/json")
.build();
HttpResponse<String> response = httpClient.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());var data = JSON.stringify({
"total": "100.53",
"description": "Checkout de Prueba",
"reference": "260520210954",
"currency": "ARS",
"test": true,
"return_url": "https://unicobros.com.ar/return_url",
"webhook": "https://unicobros.com.ar/webhook",
"multivendor":"active",
"merchants": [
{
"uid": "demo_uid"
}
],
"customer": {
"email": "[email protected]",
"name": "Cliente Demo",
"identification": "12123123"
}
});
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.unicobros.com.ar/p/checkout");
xhr.setRequestHeader("x-api-key", "zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj");
xhr.setRequestHeader("x-access-token", "d31f0721-2f85-44e7-bcc6-15e19d1a53cc");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.send(data);import requests
import json
url = "https://api.unicobros.com.ar/p/checkout"
payload = json.dumps({
"total": "100.53",
"description": "Checkout de Prueba",
"reference": "260520210954",
"currency": "ARS",
"test": True,
"return_url": "https://unicobros.com.ar/return_url",
"webhook": "https://api.unicobros.com.ar/webhook",
"customer": {
"email": "[email protected]",
"name": "Cliente Demo",
"identification": "12123123"
}
})
headers = {
'x-api-key': 'zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj',
'x-access-token': 'd31f0721-2f85-44e7-bcc6-15e19d1a53cc',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
{
"result": true,
"data": {
"id": "EC27WUC5YH5MHT0J9I",
"url": "https://sugaway.com/p/checkout/v2/EC27WUC5YH5MHT0J9I",
"description": "Checkout de Prueba",
"currency": "ARS",
"total": 100.53,
"created": 1622033797494
}
}Ejemplos del nodo sources:
{
"sources": ["visa", "mastercard"]
}Ejemplos del nodo installments:
Eisten 3 formas de Limitar Planes:
- Ocultar determinados planes de todo el conjunto de planes existentes:
Estos planes se pueden oxcultar por referencia o por ID de plan
{
"installments": ["-ahora_12", "-ahora_18"]
}- Limitar los Planes a las elegidos en el Array:
Estos planes se pueden limitar por referencia o por ID de plan
{
"installments": ["1", "3", "ahora_12"]
}- Mostrar planes especiales basado en Reglas Avanzadas:
{
"installments": ["+uid:XPDhreMoG7","+uid: ID Regla Avanzada"]
}Importante
Duración del Checkout
El checkout creado sólo podrá ser utilizado por 60 ( o el tiempo definido en la variable Timeout ) minutos, luego de esto expirará. Si el cliente intenta pagar luego de este periodo será redireccionado a la url declarada en return_url con status 401 (Expirado).
Atributo "reference"
Este atributo es utilizado para evitar pagos duplicados. Debe ser único para cada operación de pago a identificar, ya que Unicobros NO permitirá 2 transacciones en estado "Pago" con el mismo reference.
Retorno
Transacción Finalizada
Al definir el parámetro return_url el servicio redireccionará a la URL provista mediante HTTP Get una vez finalizada la transacción. A esta url se le agregará el Estado de la misma mediante el parámetro status, el tipo de transacción generada por el usuario mediante el parámetro type (cash/card) y el identificador de la transacción mediante el parámetro transactionId.
Ejemplo:
https://unicobros.com/thank_you?status=200&type=cash&transactionId=NfkvurRUX
Transacción Cancelada
Si el usuario cancela la operación status será 0 y type será none. Esto como se señala indica que el usuario no finalizó la operación y decidió volver al sitio.
Ejemplo:
https://unicobros.com/thank_you?status=0&type=none&transactionId=-1
- IDstringrequiredDescription
- x-api-keystringrequiredDescription
- x-access-tokenstringrequiredDescription
fetch("https://api.unicobros.com.ar/p/checkout/EC27WUC5YH5MHT0J9I", {
"method": "GET",
"headers": {
"Accept": "application/json",
"x-api-key": "zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj",
"x-access-token": "d31f0721-2f85-44e7-bcc6-15e19d1a53cc"
}
})
.then(response => {
console.log(response);
})
.catch(err => {
console.error(err);
});{
"name": "Cake's name",
}