Sign in

v1

latestOpenAPI 3.0.02026-07-26168846732.2 KB
Relay

Relay - Create

Creates a relay request.

post/relay

Headers

X-Profile-Idstring required

Profile ID for authentication

X-Idempotency-Keystring required

Idempotency Key for relay request

Request body

connector_resource_idstring required

The identifier that is associated to a resource at the connector reference to which the relay request is being made

connector_idstring required

Identifier of the connector ( merchant connector account ) which was chosen to make the payment

type'refund' | 'capture' | 'incremental_authorization' | 'void' | 'unreferenced_refund' required

Example request

{
  "connector_resource_id": "7256228702616471803954",
  "connector_id": "mca_5apGeP94tMts6rg3U3kR",
  "data": {
    "refund": {
      "amount": 6540,
      "reason": "Customer returned the product"
    }
  }
}

Response

Relay request

idstring required

The unique identifier for the Relay

status'created' | 'pending' | 'success' | 'failure' required
connector_resource_idstring required

The identifier that is associated to a resource at the connector reference to which the relay request is being made

connector_reference_idstring nullable

The identifier that is associated to a resource at the connector to which the relay request is being made

connector_idstring required

Identifier of the connector ( merchant connector account ) which was chosen to make the payment

profile_idstring required

The business profile that is associated with this relay request.

type'refund' | 'capture' | 'incremental_authorization' | 'void' | 'unreferenced_refund' required

Example response

{
  "id": "relay_mbabizu24mvu3mela5njyhpit4",
  "connector_resource_id": "pi_3MKEivSFNglxLpam0ZaL98q9",
  "connector_reference_id": "re_3QY4TnEOqOywnAIx1Mm1p7GQ",
  "connector_id": "mca_5apGeP94tMts6rg3U3kR",
  "profile_id": "pro_abcdefghijklmnopqrstuvwxyz",
  "data": {
    "refund": {
      "amount": 6540,
      "reason": "Customer returned the product"
    }
  }
}