Pagos
Payments

Pago en un sólo paso

Changed on

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

Request

  • Base URL
    https://api.paylands.com/v1/sandbox
  • URL
    https://api.paylands.com/v1/sandbox/charge
  • Auth
    none required

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.

Changes

  • 6a6bfbb3c872Revision changes
    • breaking

      removed the enum value ja of the request property ///

    • warning

      added the new jp enum value to the //// response property for the response status

    • info

      added the new jp enum value to the request property ///

    • info

      removed the ja enum value from the //// response property for the response status

  • 5da105946d00Revision changes
    • breaking

      removed the enum value jp of the request property ///

    • warning

      added the new ja enum value to the //// response property for the response status

    • info

      added the new ja enum value to the request property ///

    • info

      removed the jp enum value from the //// response property for the response status