latestOpenAPI 3.0.02026-08-1411579732.4 KB

6bf9c0ba354b

Pagos
Payments

Pago en un sólo paso

Permite generar una orden de cobro, almacenar la tarjeta y realizar el pago en una sola petición. Sólo usable por clientes PCI.

Si el pago es no seguro y se proporciona el TraceID en el campo extra_data.cof.txnid, se realizará un pago directo (MIT).

Si el pago es seguro se devolverá el enlace al pago tokenizado por 3DS para que el usuario finalice el pago de forma segura. En caso de que el antifraude detecte riesgo, se devolverá un enlace para que el usuario finalice el pago tokenizado por 3DS.

Si se envían datos de tarjetas dinámicas (DPAN) como aquellas obtenidas a través de Google Pay, Apple Pay o VTS/MDES, es obligatorio enviar los campos cryptogram y eci en el objeto dpan_data si se trata de una CIT. En pagos MIT, basta con indicar los datos de la tarjeta y el TraceID.

post/charge

Parameters

#/paths/~1/get/parameters/0 — unresolved $ref

Request body

signatureSignature required— unresolved $ref
amountAmount required— unresolved $ref
operativeOperative required— unresolved $ref
secureSafe required— unresolved $ref
customer_ext_idExternalId required— unresolved $ref
serviceServiceUuid required— unresolved $ref
descriptionstring required

Descripción del pago. Para los pagos mediante transferencia bancaria, el concepto que verá el usuario será el indicado en este campo.

additionalAdditional — unresolved $ref
url_postUrlPost — unresolved $ref
url_okUrlOk — unresolved $ref
url_koUrlKo — unresolved $ref
template_uuidDccTemplate — unresolved $ref
dcc_template_uuidDccTemplate — unresolved $ref
card_holderHolder required— unresolved $ref
card_panstring required

Número de la tarjeta.

card_expiry_monthExpireMonth required— unresolved $ref
card_expiry_yearExpireYear required— unresolved $ref
card_additionalAdditional — unresolved $ref
card_cvvCardCvv — unresolved $ref
customer_ipCustomerIp — unresolved $ref
referenceReference — unresolved $ref
dynamic_descriptorDynamicDescriptor — unresolved $ref
expires_innumber nullable

Tiempo en segundos desde que se crea la orden hasta que expira.

Example request

{
  "signature": "341f7de8e6fc49da8d8736473af6b03a",
  "amount": 100,
  "operative": "AUTHORIZATION",
  "secure": false,
  "customer_ext_id": "test",
  "service": "9A1BDCC8-DB30-4ED2-8523-62B330A67873",
  "description": "Payment #1",
  "additional": null,
  "url_post": "https://my.website.com/process",
  "url_ok": "https://my.website.com/ok",
  "url_ko": "https://my.website.com/ko",
  "template_uuid": "6412549E-933E-4DFE-A225-2E87FBF7623E",
  "dcc_template_uuid": "BF418CA6-7043-4864-B36F-F02C2CF2B76B",
  "card_holder": "Jose",
  "card_pan": "4761739000060016",
  "card_expiry_month": "12",
  "card_expiry_year": "21",
  "card_additional": "Card additional",
  "card_cvv": "123",
  "customer_ip": "127.0.0.1",
  "reference": "50620",
  "dynamic_descriptor": "PNP*NombreComercio",
  "threeds_data": {
    "version": 2.2,
    "trans_status": "Y",
    "eci": 5,
    "cavv": "012fE34RTD34567AkFlR98Ol65Fr",
    "ds_trans_id": "ba2fad84-2a9f-4a5a-8ca6-9eb74f7908ac"
  },
  "expires_in": 3600
}

Response

OK

messagestring required

Nombre del código HTTP de respuesta.

codenumber required

Código de respuesta.

current_timestring required

Fecha y hora de la petición.