> For a complete page index, fetch https://docs.transak.com/llms.txt # Transaction Process API POST https://api-gateway-stg.transak.com/api/v2/transaction-session/card/request/{requestId}/process Triggers processing of a payment request that was created by the Transak frontend after the user submitted their card payment details. This processes the `requestId` returned by the fiat-payment service. Reference: https://docs.transak.com/api/headless-cards/transaction-process-api ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: headless-cards-api version: 1.0.0 paths: /api/v2/transaction-session/card/request/{requestId}/process: post: operationId: transaction-process-api summary: Transaction Process API description: >- Triggers processing of a payment request that was created by the Transak frontend after the user submitted their card payment details. This processes the `requestId` returned by the fiat-payment service. tags: - '' parameters: - name: requestId in: path description: >- The request ID returned by the fiat-payment service after card tokenisation. required: true schema: type: string - name: x-access-token in: header description: >- Your Partner Access Token. Please refer [here](/guides/how-to-create-partner-access-token) for a tutorial on generating your access token. Note: This is applicable only for [Auth Reliance Flows](/features/auth-reliance) required: false schema: type: string - name: x-user-identifier in: header description: >- The authenticated user's email address. Note: This is applicable only for [Auth Reliance Flows](/features/auth-reliance). required: false schema: type: string - name: authorization in: header description: >- Authorization token is the accessToken received from the API -` api/v2/auth/verify` Note: This is not applicable for [Auth Reliance Flows](/features/auth-reliance) required: false schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/OrderCreatedResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ApiErrorBody' '404': description: Request ID Not Found content: application/json: schema: $ref: '#/components/schemas/ApiErrorBody' '422': description: Unprocessable Entity content: application/json: schema: $ref: '#/components/schemas/ApiErrorBody' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ApiErrorBody' servers: - url: https://api-gateway-stg.transak.com description: https://api-gateway-stg.transak.com components: schemas: OrderCreatedResponseDataPaymentDetailsItems: type: object properties: {} title: OrderCreatedResponseDataPaymentDetailsItems OrderCreatedResponseDataAddressAdditionalData: type: object properties: name: type: string displayName: type: string value: type: string requestId: type: string title: OrderCreatedResponseDataAddressAdditionalData OrderCreatedResponseData: type: object properties: paymentDetails: type: array items: $ref: '#/components/schemas/OrderCreatedResponseDataPaymentDetailsItems' orderId: type: string description: Unique identifier for the created order. partnerUserId: type: string description: Partner's user identifier associated with this order. status: type: string description: Current order status (e.g. AWAITING_PAYMENT_FROM_USER). isBuyOrSell: type: string description: Indicates whether the order is a BUY or SELL. fiatCurrency: type: string description: Fiat currency used for the order. cryptoCurrency: type: string description: Crypto asset being purchased. paymentMethod: type: string description: Payment method used. Always `credit_debit_card` for this flow. network: type: string description: Blockchain network for the crypto asset. networkId: type: string description: Chain ID of the network. walletAddress: type: string description: Destination wallet address for the crypto. quoteId: type: string description: Quote ID used to create this order. fiatAmount: type: number format: double description: Fiat amount for the order. fiatAmountInUsd: type: number format: double description: Fiat amount converted to USD. amountPaid: type: number format: double description: Amount already paid by the user. cryptoAmount: type: number format: double description: Crypto amount the user will receive. conversionPrice: type: number format: double description: Fiat-to-crypto conversion rate. totalFeeInFiat: type: number format: double description: Total fee charged in fiat currency. txHash: type: string description: >- Blockchain transaction hash. Empty until the transaction is confirmed on-chain. walletLink: type: string description: Block explorer link for the wallet address. transactionLink: type: string description: Block explorer link for the transaction. addressAdditionalData: $ref: '#/components/schemas/OrderCreatedResponseDataAddressAdditionalData' required: - orderId - status - isBuyOrSell - fiatCurrency - cryptoCurrency - paymentMethod - network - fiatAmount - fiatAmountInUsd - cryptoAmount description: Order details returned after processing the card transaction session. title: OrderCreatedResponseData OrderCreatedResponse: type: object properties: data: $ref: '#/components/schemas/OrderCreatedResponseData' description: >- Order details returned after processing the card transaction session. required: - data description: Order created successfully. title: OrderCreatedResponse ApiErrorBodyError: type: object properties: statusCode: type: integer message: type: string errorCode: type: integer description: Machine-readable error code for client handling. required: - statusCode - message title: ApiErrorBodyError ApiErrorBody: type: object properties: error: $ref: '#/components/schemas/ApiErrorBodyError' required: - error title: ApiErrorBody ``` ## Examples **Request** ```json {} ``` **Response** ```json { "data": { "orderId": "d4746d84-65ff-4d7b-9e50-57772fa42dc6", "status": "AWAITING_PAYMENT_FROM_USER", "isBuyOrSell": "BUY", "fiatCurrency": "EUR", "cryptoCurrency": "ETH", "paymentMethod": "credit_debit_card", "network": "ethereum", "fiatAmount": 26, "fiatAmountInUsd": 30.25, "cryptoAmount": 0.01381009, "paymentDetails": [ { "cardType": "Visa", "lastFourDigits": "4242", "expiryMonth": 12, "expiryYear": 2026, "billingAddress": { "street": "123 Main St", "city": "Berlin", "state": "Berlin", "postalCode": "10115", "country": "DE" } } ], "partnerUserId": "ef21471f-663e-4aa1-bef5-c992784a65b6", "networkId": "1", "walletAddress": "0x154196c48ef6460760096b53be440eb637f9f10f", "quoteId": "db75a098-2d1a-48d5-b6a6-0930422d37c9", "amountPaid": 0, "conversionPrice": 0.000552403731428593, "totalFeeInFiat": 1, "txHash": "", "walletLink": "https://sepolia.etherscan.io/address/0x154196c48ef6460760096b53be440eb637f9f10f", "transactionLink": "", "addressAdditionalData": { "name": "User Wallet", "displayName": "Primary ETH Wallet", "value": "0x154196c48ef6460760096b53be440eb637f9f10f", "requestId": "05cba77d-6a99-43cf-9356-2575f1db2f65" } } } ``` **SDK Code** ```python Success import requests url = "https://api-gateway-stg.transak.com/api/v2/transaction-session/card/request/:requestId/process" payload = {} headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Success const url = 'https://api-gateway-stg.transak.com/api/v2/transaction-session/card/request/:requestId/process'; const options = {method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{}'}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Success package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api-gateway-stg.transak.com/api/v2/transaction-session/card/request/:requestId/process" payload := strings.NewReader("{}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Success require 'uri' require 'net/http' url = URI("https://api-gateway-stg.transak.com/api/v2/transaction-session/card/request/:requestId/process") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Content-Type"] = 'application/json' request.body = "{}" response = http.request(request) puts response.read_body ``` ```java Success import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api-gateway-stg.transak.com/api/v2/transaction-session/card/request/:requestId/process") .header("Content-Type", "application/json") .body("{}") .asString(); ``` ```php Success request('POST', 'https://api-gateway-stg.transak.com/api/v2/transaction-session/card/request/:requestId/process', [ 'body' => '{}', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Success using RestSharp; var client = new RestClient("https://api-gateway-stg.transak.com/api/v2/transaction-session/card/request/:requestId/process"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Success import Foundation let headers = ["Content-Type": "application/json"] let parameters = [] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api-gateway-stg.transak.com/api/v2/transaction-session/card/request/:requestId/process")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```