Authorize
API Payment
- API payment/authorize digunakan untuk validasi OTP & payment_token
- Ketika validasi sukses, maka pembayaran berhasil dilakukan, dan transaksi akan disimpan di sistem Prakerja
Request
1curl --location -g --request POST 'https://api.prakerja.go.id/api/v1/integration/payment/authorize' \
2--header 'Content-Type: application/json' \
3--header 'client_code: CLIENT_CODE' \
4--header 'signature: SIGNATURE' \
5--header 'timestamp: TIMESTAMP_UNIX_IN_SECONDS' \
6--header 'Authorization: Payment PAYMENT_TOKEN' \
7--data-raw '{
8 "otp":"OTP",
9 "invoice_url":"INVOICE_URL",
10 "invoice_code":"INVOICE_CODE"
11}'
Endpoint Path
/api/v1/integration/payment/authorize
Method
POSTHeader
Key | Value |
---|---|
Content-Type | application/json |
client_code | Unique Client ID yang disediakan Prakerja ke DP / LP. Prakerja akan menyediakan credential yaitu kombinasi client_code dan sign_key ke DP / LP. |
signature | Signature dibuat dari raw_signature yang di-hashing menggunakan algoritma HMAC-SHA1 dengan sign_key yang disediakan Prakerja ke DP / LP |
timestamp | Format nilai waktu dalam satuan detik yang digunakan saat melakukan hit API Contoh 1698289216 = 26-10-2023 10:00:16 WIB = 2023-10-26T10:00:16+07:00 Timestamp digunakan di --header 'timestamp:' yang nilainya harus sama persis dengan timestamp yang digunakan untuk membuat signature. |
Authorization | payment_token yang didapat dari API Send OTP |
Body (Payload)
Field | Type | Description |
---|---|---|
otp | string, required | Kartu Prakerja ID milik user Prakerja |
invoice_url | string, required | Alamat URL dari invoice yang dibuat oleh sistem DP |
invoice_code | integer, required | Kode invoice yang dibuat oleh sistem DP |
Response
Success Response
Response 200 OK
1{
2 "success": true,
3 "message": "Pelatihan berhasil dibeli.",
4 "data": {
5 "invoice_code": "invoice-testing-ops-111",
6 "transaction_code": "QHBST9GB5OSS888I",
7 "amount": 20000,
8 "status": "SUCCESS",
9 "prakerja_name": "user skema normal 1"
10 }
11}
Response Detail
Field | Type | Description |
---|---|---|
success | boolean | Status hit API,
|
message | string | Deskripsi status hit API |
data.invoice_code | string | Kode invoice yang dibuat oleh sistem DP |
data.transaction_code | string | Kode / ID transaksi yang dibuat oleh sistem Prakerja |
data.amount | string | Harga yang dibayarkan untuk membeli pelatihan |
data.status | string | Status transaksi |
data.prakerja_name | string | User Prakerja yang membeli pelatihan |
Error Response
- Termasuk juga list error general response
- Response 400 Bad Request Token Payment tidak valid.
1{ 2 "code": "ERRPLT40034", 3 "message": "Token Payment tidak valid.", 4 "success": false 5}
- Response 400 Bad Request claim token payment tidak valid
1{ 2 "code": "ERRTRX40032", 3 "message": "Token Payment tidak valid.", 4 "success": false 5}
Try this API
Example Code
1// Generated by Prakerja Generator
2// for complete documentation please visit https://developer.prakerja.go.id
3
4const crypto = require('crypto-js');
5const axios = require('axios');
6
7const client_code = ''; // provided by Prakerja
8const timestamp = Math.round((new Date()).getTime() / 1000); // generate current timestamp
9const method = 'POST'; // API Method
10const endpoint = '/api/v1/integration/payment/authorize'; // API Redeem Status Endpoint
11
12const data = {};
13
14const input = client_code + timestamp + method + endpoint + 'Payment null' + JSON.stringify(data); // create signature input
15const sign_key = ''; // provided by Prakerja
16
17const signature = crypto.HmacSHA1(input, sign_key).toString(crypto.enc.Hex); // generate signature
18
19axios({
20method: 'post',
21url: 'https://testapi123.prakerja.go.id' + endpoint,
22headers: {
23 'Content-Type': 'application/json',
24 'client_code': client_code,
25 'signature': signature,
26 'timestamp': timestamp,
27 'Authorization': 'Payment null',
28},
29data
30})
31.then((response) => {
32console.log(response.data)
33})
34.catch((error) => {
35console.log(error.response.data)
36});
1<?php
2// Generated by Prakerja Generator
3// for complete documentation please visit https://developer.prakerja.go.id
4
5$client_code = ''; // provided by Prakerja
6$timestamp = time(); // generate current timestamp
7$method = 'POST'; // API Method
8$endpoint = '/api/v1/integration/payment/authorize'; // API Redeem Status Endpoint
9
10$data = [];
11
12$input = $client_code . $timestamp . $method . $endpoint . 'Payment null' . json_encode($data); // create signature input
13$sign_key = ''; // provided by Prakerja
14
15$signature = hash_hmac('sha1', $input, $sign_key); // generate signature
16
17$headers = [
18'Content-Type: application/json',
19'client_code: ' . $client_code,
20'signature: ' . $signature,
21'timestamp: ' . $timestamp,
22'Authorization': 'Payment null',
23];
24
25$ch = curl_init();
26curl_setopt($ch, CURLOPT_URL, 'https://testapi123.prakerja.go.id' . $endpoint );
27curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
28curl_setopt($ch, CURLOPT_POST, 1);
29curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
30curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
31$result = curl_exec($ch);
32curl_close ($ch);
33
34print_r("result: ");
35print_r($result);
1# Generated by Prakerja Generator
2# for complete documentation please visit https://developer.prakerja.go.id
3
4from hashlib import sha1
5import hmac
6import time
7import json
8import requests
9
10client_code = '' # provided by Prakerja
11timestamp = str(int(time.time())) # generate current timestamp
12method = 'POST' # API Method
13endpoint = '/api/v1/integration/payment/authorize' # API Redeem Status Endpoint
14
15data = {}
16
17# create signature input
18input = client_code + timestamp + method + endpoint + 'Payment null' + json.dumps(data, separators=(',', ':'))
19
20sign_key = '' # provided by Prakerja
21
22# generate signature
23signature = hmac.new(sign_key.encode("utf-8"), input.encode("utf-8"), sha1).hexdigest()
24
25headers = {
26'Content-Type': 'application/json',
27'client_code': client_code,
28'signature': signature,
29'timestamp': timestamp,
30'Authorization': 'Payment null'
31}
32
33result = requests.post(
34'https://testapi123.prakerja.go.id' + endpoint,
35headers=headers,
36data=json.dumps(data)
37)
38
39print('result: ')
40print(result.text)
1# Generated by Prakerja Generator
2# for complete documentation please visit https://developer.prakerja.go.id
3
4require 'base64'
5require 'cgi'
6require 'openssl'
7require 'net/http'
8require 'uri'
9require 'json'
10
11client_code = '' # provided by Prakerja
12timestamp = String(Time.now.to_i) # generate current timestamp
13method = 'POST' # API Method
14endpoint = '/api/v1/integration/payment/authorize' # API Redeem Status Endpoint
15
16data = {}
17
18# create signature input
19input = client_code + timestamp + method + endpoint + 'Payment null' + JSON.generate(data, quirks_mode: true)
20
21key = '' # provided by Prakerja
22
23signature = OpenSSL::HMAC.hexdigest(OpenSSL::Digest::Digest.new('sha1'), key.encode("ASCII"), input.encode("ASCII"))
24
25uri = URI.parse('https://testapi123.prakerja.go.id' + endpoint)
26request = Net::HTTP::Post.new(uri)
27request.content_type = "application/json"
28request.body = JSON.generate(data, quirks_mode: true)
29request['Client_code'] = client_code
30request['Signature'] = signature
31request['Timestamp'] = timestamp
32request['Authorization'] = 'Payment null'
33
34req_options = {
35use_ssl: uri.scheme == "https",
36}
37
38result = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
39http.request(request)
40end
41
42# result.code
43# result.body
44puts 'result: ' + result.body